nginx: /healthz JSON 엔드포인트 빠르게 만들기
업스트림 없이 nginx만으로 상태 확인용 엔드포인트를 제공하는 패턴(로드밸런서/모니터링용)
가벼운 서비스에서는 “앱까지 가지 않아도 되는” 헬스체크가 필요할 때가 있습니다. nginx에서 고정 응답으로 /healthz를 제공하면, 로드밸런서/업타임 체크가 단순해집니다.
JSON 응답
location = /healthz {
default_type application/json;
return 200 '{"ok":true}';
}
텍스트 응답(더 단순)
location = /health {
default_type text/plain;
return 200 "ok";
}
체크리스트
- 외부에 공개할지/내부만 쓸지 정책을 정합니다. (예: 방화벽, allowlist)
- 앱 헬스(
/health가 DB까지 체크)와 nginx 헬스(단순) 역할을 분리합니다.