오류 기록 모으기

손님 화면에서 난 오류는 사장님 눈에 안 보여요. 오류가 날 때마다 한 줄씩 자동으로 적히게 해 두면, 무엇부터 고칠지가 추측이 아니라 순위표로 나와요.

쉽게 말하면

가게 문이 뻑뻑해서 못 열고 돌아간 손님을 떠올려 보세요. 그 손님은 항의하지 않아요. 그냥 갑니다. 사장님은 오늘 손님이 좀 없었네 하고 넘어가요. 그런데 문에 "몇 시에 몇 명이 문을 못 열고 돌아갔는지" 자동으로 적히는 종이가 붙어 있다면요? 그날 저녁에 종이를 보고 경첩을 고치겠죠. 오류 기록이 그 종이예요. 말없이 돌아간 손님의 흔적을 대신 남겨 줘요.

기록이 없을 때

"요즘 주문이 좀 줄었네" (왜 줄었는지는 모름)

결제 화면이 특정 폰에서 3주간 멈춰 있었어도 알 방법이 없어요. 손님은 말 안 하고 나가요.

기록이 있을 때

결제 확인 화면 · 오류 412건 · 대부분 같은 브라우저

고칠 것이 한 줄로 지목돼요. 어디를 뒤질지 고민하는 시간이 사라져요.

핵심은 손님이 "안 되는데요"라고 말해 주기를 기다리지 않는 거예요. 말해 주는 손님은 백 명 중 한두 명이에요. 나머지는 조용히 나가고, 사장님은 매출 숫자만 보고 이유를 짐작해요. 기록은 그 짐작을 사실로 바꿔 줘요.

내 폰에서는 잘 되는데 왜 손님은 안 될까

사장님이 만든 화면을 사장님 폰에서 눌러 보고 잘 되면 다 된 것 같아요. 그런데 손님의 환경은 사장님 것과 조금씩 다 달라요. 그 차이가 오류를 만들어요.

차이가 나는 곳	사장님에게 안 보이는 이유	손님에게는 이렇게 보여요
폰 종류와 브라우저	내 폰 하나로만 확인했으니 표본이 한 개예요	버튼이 화면 밖으로 밀려서 누를 수가 없어요
느리거나 끊기는 인터넷	사장님은 와이파이 옆에서 눌러요	저장을 눌렀는데 한참 돌다가 아무 일도 안 일어나요
누르는 순서	사장님은 만든 사람이라 정해진 순서로만 눌러요	뒤로 갔다 다시 오면 화면이 텅 비어 있어요
손님이 넣는 값	테스트할 때는 늘 반듯한 값을 넣어요	이름에 괄호를 넣거나 칸을 비우면 저장이 안 돼요
로그인 상태	사장님은 항상 로그인된 상태로 봐요	처음 온 손님에게만 빈 화면이 떠요
날짜와 시간	오늘 날짜로만 눌러 봤어요	월말이나 자정 넘어서 예약하면 날짜가 하루 밀려요

그래서 "제 폰에서는 잘 되던데요"는 확인이 아니라 표본 한 개예요. 손님이 열 명이면 환경이 열 가지고, 백 명이면 백 가지예요. 사람이 다 눌러 볼 수 없으니 기계가 대신 적게 하는 거예요.

쓸모 있는 기록에는 여섯 칸이 있어요

기록이라고 다 쓸모 있는 건 아니에요. "오류 발생"만 잔뜩 쌓여 있으면 안 쌓인 것과 같아요. 나중에 고칠 때 진짜로 쓰이는 칸은 여섯 개예요.

칸	이 칸이 없으면
언제 났나	어제 저녁 배포 때문인지, 원래 그랬는지 구분이 안 돼요
어느 화면 · 어느 버튼	사이트 전체를 처음부터 뒤지게 돼요
오류 문구 원문	짐작으로 고치게 돼요. 엉뚱한 곳을 세 번 고치고 원래대로 돌아와요
폰 종류와 브라우저	특정 기기에서만 나는 문제를 영원히 못 잡아요
직전에 무엇을 눌렀나	다시 재현할 수가 없어요. 못 재현하는 오류는 못 고쳐요
같은 오류가 몇 번 · 몇 사람	무엇부터 고칠지 순위를 못 정해요

여섯 칸에 없는 것

이름 · 전화번호 · 주소 · 카드번호는 이 여섯 칸에 들어가지 않아요. 고치는 데 필요 없고, 남기면 지켜야 할 것이 하나 늘어나요. 자세한 건 아래 "기록에 담으면 안 되는 것"에서 이어서 말해요.

증상 하나에 주문 하나

기록을 봐서 증상을 알았으면, 그다음은 AI에게 정확히 말하는 일이에요. 아래 표의 오른쪽 칸을 그대로 복사해서 쓰세요. 대괄호 안만 사장님 상황으로 바꾸면 돼요.

기록에 이렇게 남아 있어요	이렇게 말하면 돼요
같은 화면에서 같은 오류가 매일 수십 건	"[결제 확인] 화면에서 같은 오류가 하루 수십 번 납니다. 오류 문구 원문은 이거예요. 여기 붙입니다. 증상만 감추지 말고 원인부터 찾아서 고쳐 주세요."
어제 저녁부터 갑자기 시작됨	"어제 저녁 새로 올린 뒤부터 이 오류가 시작됐어요. 그때 바뀐 부분 중에 이 오류를 만들 수 있는 걸 짚어 주세요."
특정 폰이나 브라우저에서만	"[아이폰 사파리]에서만 이 오류가 나고 다른 기기에서는 안 나요. 그 브라우저에서만 다르게 동작하는 부분을 찾아 주세요."
오류는 없는데 아무 반응이 없다는 신고	"[저장] 버튼을 눌렀을 때 성공도 실패도 아무 표시가 없는 경우가 있어요. 실패했을 때 손님에게 보여 줄 문구와 다시 시도 버튼을 넣어 주세요."
기록 자체가 하나도 안 쌓임	"손님 화면에서 오류가 나면 자동으로 기록되게 만들어 주세요. 언제 · 어느 화면 · 오류 문구 · 기기 정보가 남게 하고, 이름이나 전화번호 같은 개인 정보는 기록에 넣지 마세요."
기록이 너무 많아서 볼 수가 없음	"같은 오류는 한 줄로 묶고 몇 번 났는지 숫자만 보여 주세요. 새로 생긴 오류는 맨 위로 올려 주세요."
오래 기다리다 끊긴 흔적	"이 요청이 오래 걸리다 끊기는 것 같아요. 얼마나 기다렸는지도 기록에 남기고, 오래 걸릴 때 손님에게 알리고 다시 시도할 수 있게 해 주세요."
특이한 입력값에서만 오류	"[이름] 칸에 특이한 값이 들어오면 오류가 나요. 저장 전에 확인해서 손님에게 무엇을 고쳐야 하는지 알려 주게 해 주세요."

문구는 요약하지 말고 원문으로

오류 문구를 "뭐 저장이 안 된다는 내용이었어요"로 옮기면 절반이 날아가요. 알아볼 수 없는 영어라도 글자 그대로 복사해서 붙이세요. 사장님에게는 외국어지만 AI에게는 주소예요. 읽는 법을 모르겠으면 에러 읽는 법을 먼저 보세요.

사장님이 실제로 겪는 장면

장면 1 · 손님이 전화로 말했다

“어제 저녁에 결제하려고 했는데 안 되던데요. 그냥 다른 데서 샀어요.”

기록이 없으면 여기서 대화가 끝나요. "죄송합니다" 말고 할 말이 없어요. 기록이 있으면 어제 저녁 그 시간대를 열어서 어느 단계까지 갔다가 어디서 멈췄는지를 그 자리에서 확인해요. 그리고 같은 일을 겪은 다른 손님이 몇 명이었는지도 같이 보이죠. 전화 한 통이 신고가 아니라 단서가 돼요.

장면 2 · 외주 개발자가 말했다

“저쪽에서는 재현이 안 돼서요. 로그 좀 받을 수 있을까요?”

핀잔이 아니에요. 내 컴퓨터에서는 그 오류가 안 나니 손님 쪽에서 무슨 일이 있었는지 적힌 것을 달라는 뜻이에요. 이때 기록이 없으면 개발자는 짐작으로 고치고, 짐작으로 고친 건 다시 터져요. 기록을 미리 켜 두는 건 나중에 남에게 맡길 때의 준비이기도 해요.

장면 3 · 기록을 켠 첫 주

“일주일에 오류가 300건이나 쌓였어요. 이거 큰일 난 거 아닌가요?”

거의 항상 반대예요. 300건을 종류별로 묶어 보면 두세 종류가 90퍼센트를 차지해요. 즉 고칠 것은 두세 개고, 그걸 고치면 다음 주 숫자가 뚝 떨어져요. 숫자가 크게 보이는 건 문제가 많아진 게 아니라 원래 있던 게 처음 보이기 시작한 것이에요.

손님의 "안 돼요"를 기록으로 바꾸는 세 줄

기계가 적는 기록을 붙이기 전에도 쓸 수 있는 방법이 있어요. 손님이 문의로 "안 돼요"라고 보내면, 그 말은 그대로는 단서가 아니에요. 세 가지만 되물으면 그 문의가 위 표의 왼쪽 칸으로 바뀌어요.

1"어느 화면에서였는지 기억나세요?" 화면 이름 하나만 알면 뒤질 범위가 사이트 전체에서 한 곳으로 줄어요. "결제 누르고 다음 화면"처럼 대충이어도 충분해요.
2"화면에 무슨 글씨가 떴는지 캡처가 있으세요?" 캡처 한 장이 문의 열 줄보다 정확해요. 손님이 옮겨 적은 말은 이미 요약된 말이라 절반이 날아가 있어요.
3"폰으로 보셨나요, 컴퓨터로 보셨나요?" 이 한 줄이 특정 기기에서만 나는 문제를 잡아요. 기종까지 말해 주면 더 좋지만 폰인지 컴퓨터인지만도 크게 좁혀져요.

물어볼 순서까지 정해 두면 더 편해요

이 세 줄을 문의 답장 서식에 미리 넣어 두면 사장님이 매번 생각할 일이 없어져요. 손님도 취조받는 기분이 안 들게 "바로 확인해 드릴게요"를 앞에 붙이는 게 좋아요. 답장 서식 자체를 만들어 두는 얘기는 답장 서식 만들기에 있어요.

지금은 신경 쓰지 않아도 되는 때

이런 문서는 보통 겁을 줘서 시키려고 해요. 그건 정직하지 않아요. 오류 기록은 켤 시점이 오면 켜면 되는 것이고, 그 시점이 아직 안 온 사장님이 훨씬 많아요.

이럴 때는	왜 안 해도 되나
아직 손님이 없고 혼자 만들고 있을 때	오류가 나면 사장님 화면에 바로 보여요. 기록은 내가 못 보는 곳을 위한 장치예요
하루 방문이 손으로 셀 정도일 때	손님 한 명 한 명과 말이 통해요. 전화 한 통이 어떤 기록보다 빠르고 정확해요
이번 주에 끝나는 행사 페이지 하나뿐일 때	고칠 시간이 없는 것을 모으는 건 낭비예요. 다음 행사 때 쓸 것도 아니고요
쌓아 두고 볼 사람이 없을 때	아무도 안 보는 기록은 비용만 내는 창고예요. 볼 요일을 정할 수 없으면 아직이에요
이미 원인을 알고 있는 오류일 때	더 모을 게 없어요. 모으는 대신 고치는 게 순서예요
만드는 중에 잠깐 나는 오류일 때	만드는 동안은 오류가 나는 게 정상이에요. 아직 안 만든 부분이니까요

켤 시점을 알아보는 한 문장

"내가 안 보고 있는 시간에 손님이 들어오기 시작했나?" 여기에 그렇다고 답하는 날이 켜는 날이에요. 밤에 자는 동안 주문이 들어오고, 사장님이 없는 시간에 문의가 쌓이기 시작하면 그때부터 기록이 사장님의 눈을 대신해요. 그 전까지는 눈이 이미 거기 있어요.

기록에 담으면 안 되는 것

기록은 편해서 자꾸 다 담게 돼요. 그런데 담는 순간 그건 지켜야 하는 자료가 돼요. 오류를 고치는 데 필요한 것만 담고 나머지는 버리는 게 이득이에요.

1이름 · 전화번호 · 주소 대신 손님 번호만 남겨요. "3번 손님"이면 어느 손님인지 사장님은 찾을 수 있고, 기록만 새어도 그 사람이 누군지는 안 새요.
2카드번호 · 비밀번호 · 인증번호는 어떤 형태로도 담지 않아요. 오류를 고치는 데 필요한 적이 단 한 번도 없어요. 담을 이유가 없는데 위험만 있어요.
3주고받은 내용 전체가 아니라 오류 문구만 남겨요. 편하다고 통째로 담으면 손님이 쓴 문의 내용까지 창고에 쌓여요.
4언제까지 보관하고 언제 지울지 미리 정해요. 정해 두지 않으면 영원히 쌓여요. 지울 시점이 정해진 기록만 안전한 기록이에요.
5기록을 볼 수 있는 사람을 줄여요. 오류 기록은 팀 전체가 볼 필요가 없어요. 고치는 사람만 보면 돼요.

숫자와 조항은 확인하고 쓰세요

보관 기간이 몇 달이어야 하는지, 어떤 항목이 개인 정보에 해당하는지는 서비스 성격과 사장님이 써 둔 처리방침에 따라 달라져요. 이 문서에서 숫자를 정해 드리지 않아요. 개인정보보호위원회 안내와 한국인터넷진흥원 자료를 확인하시고, 사장님 처리방침에 적어 둔 기간과 어긋나지 않게 맞추세요. 처리방침 자체가 뭔지 헷갈리면 손님 정보 다루기를 먼저 보세요.

무엇부터 고칠지 정하는 순서

기록을 켜면 목록이 길어져요. 위에서부터 차례로 고치면 안 돼요. 위에 있는 건 그냥 방금 난 것이지 중요한 게 아니에요. 순서는 이렇게 정해요.

1돈이 지나가는 길에서 난 오류를 맨 위로 올려요. 결제 · 주문 확정 · 문의 보내기 · 예약 확정이 그 길이에요. 여기 오류 하나가 다른 화면 오류 백 개보다 비싸요.
2같은 오류를 겪은 사람 수로 줄을 세워요. 횟수가 아니라 사람 수예요. 한 사람이 화가 나서 스무 번 누른 것과 스무 명이 한 번씩 막힌 것은 완전히 다른 일이에요.
3새로 생긴 것을 먼저 봐요. 어제까지 없던 오류는 어제 바꾼 것 때문일 확률이 아주 높아요. 원인이 좁혀져 있으니 가장 싸게 고칠 수 있어요.
4한 명만 한 번 겪은 특이한 오류는 맨 아래에 둬요. 무시하라는 뜻이 아니라 지금 볼 차례가 아니라는 뜻이에요. 같은 게 또 올라오면 그때 순위가 올라가요.

이 순서대로 하면 매주 고치는 개수가 아니라 막히는 손님 수가 줄어요. 고친 개수는 사장님 만족이고, 막히는 손님 수는 매출이에요. 세는 대상을 바꾸는 게 이 문서의 진짜 목적이에요.

자주 묻는 것

Q. 방문자 통계랑 오류 기록은 같은 건가요?: 다른 거예요. 통계는 몇 명이 왔고 무엇을 눌렀나를 세요. 오류 기록은 무엇이 안 됐나를 적어요. 통계는 잘된 일을 세고 기록은 안 된 일을 세요. 둘 다 있으면 좋고, 손님이 막히는 게 걱정이면 기록이 먼저예요. 통계 쪽은 무엇을 눌렀는지 세기에 있어요.
Q. 기록을 켜면 사이트가 느려지지 않나요?: 체감될 만큼은 아니에요. 오류가 났을 때만 한 줄 보내는 거라 평소에는 아무 일도 안 해요. 다만 모든 동작을 다 적게 만들면 얘기가 달라져요. 처음에는 오류만 적게 하고, 부족하면 그때 늘리세요.
Q. 오류가 0건으로 나오면 완벽한 건가요?: 먼저 기록이 진짜 켜졌는지 확인하세요. 0건은 대개 기록이 안 되고 있다는 뜻이에요. 켜져 있는데도 0건이면, 오류 없이 그냥 아무 일도 안 일어나는 경우가 남아 있을 수 있어요. 눌러도 아무 반응이 없는 자리가 그거예요.
Q. 손님도 이 기록을 보게 되나요?: 아니에요. 기록은 사장님이 보는 창고고, 손님에게는 알아들을 수 있는 안내 문구만 보여야 해요. 손님 화면에 알 수 없는 영어가 그대로 뜨고 있다면 그건 고칠 대상이에요. 오류 화면 만들기가 그 얘기예요.
Q. 오류마다 폰으로 알림을 받아야 하나요?: 아니에요. 그러면 이틀 만에 알림을 끄게 돼요. 알림은 사이트가 아예 멈췄을 때만 받고, 나머지는 요일을 정해서 몰아 보는 게 오래가요. 멈춤 알림은 사이트가 죽으면 나한테 알리기에서 다뤄요.
Q. 일주일에 얼마나 봐야 해요?: 10분이면 충분해요. 종류별로 묶인 목록에서 위 세 줄만 보세요. 지난주에 없던 게 올라왔는지, 늘 있던 게 더 늘었는지. 그 두 가지만 확인하면 그 주의 할 일이 정해져요.
Q. 기록을 모으는 데 돈이 드나요?: 쌓는 양에 따라 달라요. 오류만 적으면 아주 적게 들고, 모든 동작을 다 적으면 꽤 커져요. 창고 비용이 늘어나는 게 보이면 보관 기간을 줄이는 게 첫 손질이에요. 비용을 지켜보는 방법은 나가는 돈 지켜보기에 있어요.

확인해 보세요

기록을 보니 같은 오류가 어제 하루에 80번 났어요. 무엇을 먼저 확인해야 할까요?

하나 더

아직 손님이 하루 두세 명인데, 오류 기록을 지금 붙여야 할까요?

직접 해보기

스튜디오에서 그대로 주문해 보세요

이 문장을 복사해서 넣어 보세요. "손님 화면에서 오류가 나면 자동으로 기록되게 만들어 주세요. 언제 · 어느 화면 · 오류 문구 · 기기 정보가 남게 하고, 이름이나 전화번호 같은 개인 정보는 기록에 넣지 마세요." 마지막 문장이 있어야 담지 말아야 할 것을 안 담아요.

스튜디오에서 주문하기

더 깊이 (안 읽어도 괜찮아요)

같은 오류 100번은 손님 100명이 아니에요 · 기록은 일이 벌어진 횟수를 세는 게 기본이에요. 그런데 사람은 안 되면 다시 눌러요. 화가 나면 열 번도 눌러요. 그래서 횟수만 보면 목소리 큰 한 사람이 목록 맨 위를 차지하고, 조용히 한 번 막히고 나간 스무 명은 아래에 묻혀요. 기록을 만들 때 사람을 구분하는 번호를 같이 남겨 달라고 해 두면, 나중에 횟수와 사람 수를 따로 셀 수 있어요. 판단이 바뀌는 지점이라 처음부터 넣어 두는 게 좋아요.

가장 비싼 건 조용한 실패예요 · 오류가 나서 빨간 글씨가 뜨는 건 오히려 다행이에요. 기록에 남으니까요. 진짜 무서운 건 오류도 안 나고 성공도 안 되는 경우예요. 버튼을 눌렀는데 아무 일도 안 일어나면 기록에 적힐 오류 자체가 없어요. 이걸 잡는 방법은 실패만 적는 게 아니라 성공했을 때도 한 줄 적게 하는 거예요. 그러면 시도한 흔적은 있는데 성공 줄이 없는 자리가 드러나요. 빈칸이 증거가 되는 거예요.

숫자는 분모가 있어야 숫자예요 · "오류 412건"만으로는 심각한지 알 수 없어요. 그 주에 시도가 500번이었다면 재난이고, 50만 번이었다면 정상 범위예요. 그래서 오류 건수는 늘 그 화면을 지나간 전체 횟수와 나란히 봐야 해요. 기록을 볼 때 지난주와 이번주를 같은 기준으로 놓고 비교하는 습관도 같은 이유예요. 절대 숫자는 감정을 흔들고, 비율은 판단을 만들어요.

이것만 기억하세요

·말없이 나간 손님의 흔적을 대신 남기는 게 오류 기록이에요
·쓸모 있는 기록은 여섯 칸이에요. 언제 · 어디서 · 문구 원문 · 기기 · 직전 행동 · 몇 사람
·순위는 횟수가 아니라 사람 수와 돈이 지나가는 길로 정해요
·이름 · 전화번호 · 카드번호는 담지 않고, 지울 시점을 미리 정해요
·내가 안 보는 시간에 손님이 들어오기 시작하면 그때 켜면 돼요