nginx: /healthz JSON 엔드포인트 빠르게 만들기

업스트림 없이 nginx만으로 상태 확인용 엔드포인트를 제공하는 패턴(로드밸런서/모니터링용)

분야: DevOps/인프라 nginxhealthcheckopsobservability

가벼운 서비스에서는 “앱까지 가지 않아도 되는” 헬스체크가 필요할 때가 있습니다. 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 헬스(단순) 역할을 분리합니다.

같은 분야의 템플릿