헬스 체크 개요
헬스 체크 API는 OpenClaw Gateway가 제공하는 내장 엔드포인트로, 서비스의 운영 상태를 보고합니다. 로드 밸런서, 모니터링 시스템, 컨테이너 오케스트레이션 플랫폼에서 서비스가 정상인지 판단하는 데 사용됩니다.
기본 헬스 체크
curl http://localhost:3000/health
상세 헬스 체크
curl http://localhost:3000/health/detailed
존재 확인 및 준비 확인
curl http://localhost:3000/health/live # 프로세스 실행 여부
curl http://localhost:3000/health/ready # 요청 수신 준비 여부
Kubernetes 통합
livenessProbe:
httpGet:
path: /health/live
port: 3000
readinessProbe:
httpGet:
path: /health/ready
port: 3000
Docker 헬스 체크
healthcheck:
test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
interval: 30s
timeout: 5s
retries: 3
Prometheus 메트릭
{
"gateway": {
"metrics": {
"enabled": true,
"path": "/metrics",
"format": "prometheus"
}
}
}
정리
헬스 체크 API는 OpenClaw 프로덕션 운영의 핵심 컴포넌트입니다. 존재 확인, 준비 확인, 알림 메커니즘을 적절히 설정하면 서비스 장애의 빠른 발견과 자동 복구를 실현하여 AI 어시스턴트의 고가용성을 보장할 수 있습니다.