Health / Version

서비스 상태 확인(헬스 체크)과 설치 버전 확인 API입니다. 둘 다 인증이 필요 없는 퍼블릭 엔드포인트입니다.

엔드포인트

GET /health

설명: API 서버, Trino, PostgreSQL 연결 상태를 확인합니다.

응답 (정상):

{
  "status": "healthy",
  "trino": "connected",
  "postgresql": "connected",
  "version": "1.0.0",
  "cluster_name": "gend-local"
}

응답 (장애): 연결 실패 컴포넌트가 disconnected 로 표시되고 status 가 degraded 가 됩니다 (HTTP 는 여전히 200).

GET /version (v1.0.0+)

설명: 제품 버전과 빌드 메타데이터를 반환합니다 (ADR-0036). DB/Trino 에 접근하지 않으므로 장애 상황에서도 항상 응답합니다 — 온프렘 설치본 버전 확인·지원 문의 시 1차 판별 수단으로 사용하세요.

응답:

{
  "product": "GenD",
  "version": "1.0.0",
  "build_sha": "a27c0f4",
  "build_date": "2026-08-04T05:00Z"
}

build_sha / build_date 는 CI 빌드에서 주입되며, 로컬 빌드 이미지는 unknown 입니다 (GEND_BUILD_SHA / GEND_BUILD_DATE 환경 변수 — 환경 변수 참조).

인증

인증이 필요하지 않습니다. 퍼블릭 엔드포인트입니다.

참고

• GET /health 는 Kubernetes liveness/readiness probe로 사용됩니다.
• 연결 실패 시에도 HTTP 200을 반환하되, status가 degraded로 표시됩니다.
• UI 하단 StatusBar 의 버전 표시는 /health 의 version 값이며, 클릭하면 릴리스 노트로 이동합니다.
• Prometheus 메트릭은 GET /metrics 엔드포인트에서 별도로 노출됩니다.

에러 코드

코드	설명
500	헬스 체크 자체 실행 실패