DOCS/journey/troubleshooting/260303_9024_health_endpoint_alignment.md

9024 robeing-monitor 헬스 엔드포인트 정합

작성자: Codex

문제 상황

• 2026-03-03 기준 http://localhost:9024/health 호출 시 404 Not Found가 반환됐다.
• 동일 서비스는 /healthz만 제공하고 있어, 운영 점검 시 경로 혼선이 발생했다.

원인

• robeing-monitor 메인 앱(app/main.py)에 /healthz만 정의되어 있었다.
• 일부 서비스는 /health를 표준으로 사용하고 있어 점검 스크립트와 불일치가 생겼다.

조치

• robeing-monitor/app/main.py에 /health 호환 엔드포인트를 추가했다.
• 기존 /healthz는 유지해 하위 호환성을 보장했다.

검증

• 수정 전: curl http://localhost:9024/health -> 404 Not Found
• 배포 후: curl http://localhost:9024/health -> 200 OK 및 JSON 응답 확인 예정
• /healthz 기존 응답 유지 여부 함께 확인

교훈

• 헬스체크 경로는 서비스별로 달라도 최소한 /health와 /healthz의 호환 정책을 문서화해야 운영 혼선을 줄일 수 있다.
• 상태 점검 자동화 스크립트는 단일 경로 가정 대신 서비스별 계약을 명시적으로 반영해야 한다.