n8n 모니터링
인스턴스 상태를 확인하기 위해 호출할 수 있는 세 가지 API 엔드포인트가 있습니다: /healthz, healthz/readiness, /metrics. /healthz 엔드포인트는 표준 HTTP 상태 코드를 반환합니다.
인스턴스 상태를 확인하기 위해 호출할 수 있는 세 가지 API 엔드포인트가 있습니다: /healthz, healthz/readiness, /metrics.
healthz 및 healthz/readiness#
/healthz 엔드포인트는 표준 HTTP 상태 코드를 반환합니다. 200은 인스턴스에 연결할 수 있음을 나타냅니다. DB 상태는 나타내지 않습니다. 셀프 호스팅 및 Cloud 사용자 모두에게 제공됩니다.
엔드포인트에 접근합니다:
<your-instance-url>/healthz
/healthz/readiness 엔드포인트는 /healthz 엔드포인트와 유사하지만, DB가 연결되고 마이그레이션되어 인스턴스가 트래픽을 수락할 준비가 된 경우 HTTP 상태 코드 200을 반환합니다.
엔드포인트에 접근합니다:
<your-instance-url>/healthz/readiness
N8N_ENDPOINT_HEALTH 환경 변수를 사용하여 헬스 체크 엔드포인트 경로를 사용자 지정할 수 있습니다.
metrics#
/metrics 엔드포인트는 인스턴스의 현재 상태에 대한 더 자세한 정보를 제공합니다.
엔드포인트에 접근합니다:
<your-instance-url>/metrics
/metrics 엔드포인트는 n8n Cloud에서 사용할 수 없습니다.
셀프 호스팅 n8n에서 메트릭 및 헬스 체크 활성화#
/metrics 엔드포인트는 기본적으로 비활성화되어 있습니다. 헬스 엔드포인트는 메인 n8n 서버에서 항상 활성화되어 있습니다. 큐 모드의 워커 서버에서는 헬스 엔드포인트가 기본적으로 비활성화되어 있습니다.
활성화하려면 n8n 인스턴스를 설정합니다:
# metrics
N8N_METRICS=true
# healthz
QUEUE_HEALTH_CHECK_ACTIVE=true
환경 변수를 사용하여 인스턴스를 설정하는 방법에 대한 자세한 내용은 설정 방법을 참조하세요.