From ffe8e688caf18345c89952d399f340465f229a0b Mon Sep 17 00:00:00 2001 From: Claude-51124 Date: Tue, 3 Mar 2026 18:45:31 +0900 Subject: [PATCH] docs: add 9024 health endpoint alignment troubleshooting note --- .../260303_9024_health_endpoint_alignment.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 journey/troubleshooting/260303_9024_health_endpoint_alignment.md diff --git a/journey/troubleshooting/260303_9024_health_endpoint_alignment.md b/journey/troubleshooting/260303_9024_health_endpoint_alignment.md new file mode 100644 index 0000000..e2c899c --- /dev/null +++ b/journey/troubleshooting/260303_9024_health_endpoint_alignment.md @@ -0,0 +1,24 @@ +# 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`의 호환 정책을 문서화해야 운영 혼선을 줄일 수 있다. +- 상태 점검 자동화 스크립트는 단일 경로 가정 대신 서비스별 계약을 명시적으로 반영해야 한다.