서비스가 스스로 내보내는 신호를 공개합니다

이 세 수는 기준이고, 지금 값은 위 「지금 값 열어 보기」 버튼이 여는 /healthz에 있습니다. 이 지면에 실시간 값을 박으면 열 때마다 화면이 달라져 어제 본 화면과 오늘 본 화면을 견줄 수 없어서, 일부러 기준만 세워 뒀습니다.

멈춘 것을 모르면 빠진 값을 채워진 값으로 믿게 됩니다

측정은 조용히 실패합니다. 화면은 멀쩡합니다. 리포트도 평소처럼 나옵니다. 다만 그 안에서 몇 번의 측정이 빠져 있을 뿐입니다.

그 사실을 모르면 없는 값과 못 잰 값을 같은 것으로 보고, 그 위에 세운 판단이 통째로 틀립니다. 안 나온 것과 못 잰 것은 종이 위에서 같은 모양이기 때문입니다. 차이를 모르면 다음 달 숫자와 견줄 때 두 회차가 서로 다른 기준으로 측정한 값이 되고, 비교 자체가 성립하지 않습니다. 그래서 상태를 저희 말로 요약해 드리는 대신, 판정 기준과 지금 값을 같이 열어 둡니다.

보고 있는 신호 네 가지

서비스는 자기 상태를 네 가지 값으로 내보냅니다. 브라우저에서 /healthz를 열면 이 값들이 그대로 보입니다.

주의 상태가 되면 같은 주소가 정상일 때와 다른 응답 코드를 돌려주기 때문에, 외부 감시 도구를 붙이실 때는 본문을 읽지 않고 그 코드 하나만 보셔도 됩니다.

값을 읽는 법

돌아오는 것은 짧은 JSON 한 덩이입니다. 사람이 읽어도 바로 뜻이 보이도록 이름을 그대로 썼습니다.

이 신호가 덮는 범위

여기서 보는 것은 우리 서비스 자신입니다 — 웹 지면, 주문과 측정 작업 처리, 기록 적재. 측정 대상이 되는 바깥 검색·AI 답변 화면은 그쪽 사업자가 운영하고, 그 화면의 그날 상태는 측정 리포트 안에 관측 기록으로 함께 실립니다.

계약 진단은 완료 시점을 문서로 약속하고 진행 상황을 콘솔에서 보여 드리며, 처리에 평소보다 시간이 걸리는 회차는 물어보시기 전에 담당자가 먼저 연락드립니다.

읽지 못한 측정을 분모에서 빼지 않습니다

비율을 좋게 만드는 가장 쉬운 방법이 있습니다. 못 읽은 것을 분모에서 빼는 것입니다. 그 계산은 하지 않습니다.

파노라마 한 회차의 관측은 계획한 수입니다. 질문 50개를 엔진 15곳에 7번씩 되물어 채웁니다. 못 읽은 것은 못 읽었다고 같은 리포트에 적습니다. 잰 조건은 잰 시각의 모습으로 잠가 둡니다. 이것을 봉인이라고 부릅니다. 같은 회차에서 경쟁사를 나란히 측정하는 것도 같은 이유입니다 — 우리 값만 있으면 그 수가 높은 것인지 낮은 것인지 알 방법이 없습니다.

이 지면이 그 규율의 운영 쪽 절반입니다. 저희가 화면 뒤에서 보는 값과 여기 열어 둔 값이 같기 때문에, 설명과 실물이 어긋날 여지가 없습니다. 측정하는 쪽 절반은 측정 규격에 적혀 있습니다.

감시를 붙이실 분이 지금 고칠 것

외부 감시 도구는 본문이 아니라 응답 코드만 보게 잡으세요. 본문 문구는 우리가 고칠 수 있지만 코드는 안 바뀝니다. 문구를 보게 잡아 두면 우리가 문장 하나를 다듬은 날 감시가 헛경보를 울립니다.

주기는 1분보다 촘촘하게 잡지 마세요. 판정이 바뀌는 선이 30분이라, 그보다 훨씬 잦게 찔러도 새로 알게 되는 것이 없습니다.

점검과 변경을 알리는 방법

미리 잡은 점검이 있으면 시작 전에 이메일로 알려 드리고, 예정 시각과 영향 범위를 함께 적습니다. 계약 고객에게는 담당 연락 경로로 같은 내용이 갑니다.

지면과 자료 형식이 바뀌는 변경은 공개 자료 문서에 먼저 반영하고, 공개 지면의 최종 변경일은 /sitemap.xml에서 확인하실 수 있습니다.

이상해 보이면 알려 주세요

화면이 기대와 다르게 동작하면 메일로 알려 주세요. 언제, 어느 주소에서, 무엇을 하셨는지 세 가지만 적어 주시면 재현이 빨라집니다. 보안과 관련된 신고는 별도 경로가 있습니다 — 신뢰 센터의 보안 신고 절을 봐 주세요.

더 볼 것 — 신뢰 센터 · 공개 자료 문서 · 측정 방법론