운영 노트 41) 100점 만점인데 실패라고 뜬다
운영 노트

41) 100점 만점인데 실패라고 뜬다

2026.07.27

지식 시스템에 건강검진 기능을 달아놨다. 위키·검색 색인·메모리가 서로 어긋나지 않았는지 매번 확인하는 물건이다.

어느 날 결과가 이렇게 나왔다.

FAIL   100/100

점수는 만점인데 판정이 실패다

한참 봤다. 만점인데 실패다. 둘 중 하나는 거짓말을 하고 있다는 소리다.

뜯어보니 원인이 두 개였다.

원인 1 — 정상 작업의 부산물을 실패로 셌다

위키 문서를 고치면 그걸 재료로 만든 색인은 헌 게 된다. 당연한 일이다. 문서를 고쳤으니 색인을 다시 만들어야 하는 거고, 그건 고장이 아니라 정상 절차다.

그런데 검진은 이걸 FAIL로 쳤다. 결과가 어떻게 되냐면, 내가 일을 할 때마다 FAIL이 뜬다.

이게 진짜 문제다. 매번 뜨는 경고는 아무도 안 본다. 나도 어느 순간부터 FAIL을 보고 “아 또 그거겠지” 하고 넘기고 있었다. 그 상태에서 진짜 장애가 나면 똑같이 넘긴다. 경고를 무디게 만드는 게 경고를 안 다는 것보다 나쁘다.

원인 2 — 동기 대상이 아닌 걸 같은 잣대로 쟀다

메모리는 위키랑 갱신 주기가 다른 별개 저장소다. 그런데 검진은 “위키 대비 얼마나 신선한가”로 재고 있었다. 주기가 다르니 항상 어긋나 있고, 결과는 구조적으로 영원히 FAIL. 고칠 방법이 없는 실패다.

고친 방향

둘 다 판정 규칙 쪽을 고쳤다. 숫자를 만지지 않았다.

재빌드가 필요한 상태는 WARN으로 내렸다. 실제 장애만 FAIL이다.
메모리는 검진 항목에서 빼고 동기화 상태라는 별도 표시로 분리했다.

이제 FAIL이 뜨면 진짜 뭔가 터진 거다. 그래야 볼 가치가 있다.

건진 것

기준 자체가 틀릴 수 있다는 걸 자꾸 잊는다. 검사가 실패를 뱉으면 검사 대상부터 의심하는 게 습관인데, 오늘은 검사가 틀렸다.

특히 점수 축과 판정 축이 어긋나 보이면 — 만점인데 실패 같은 — 대상이 아니라 판정 규칙부터 뜯어야 한다. 모순이 눈에 보이는 건 운이 좋은 거다. 안 보이면 몇 달을 잘못된 경고 속에서 산다.

재발방지 체크리스트
정상 작업의 부산물을 FAIL로 부르지 않는다. 재빌드 필요=WARN, 실제 장애만 FAIL.
② 갱신 주기가 다른 저장소를 같은 신선도 잣대로 재지 않는다. 별도 항목으로 뺀다.
③ 매번 뜨는 경고를 발견하면 그 경고부터 고친다. 무뎌진 경고는 없는 것만 못하다.
④ 점수와 판정이 모순되면 판정 규칙을 먼저 의심한다.
본 사이트는 쿠팡 파트너스 및 알리익스프레스(AliExpress) 어필리에이트 활동의 일환으로, 이에 따른 일정액의 수수료를 제공받을 수 있습니다.