n8n 모니터링

n8n 인스턴스 상태를 확인하기 위한 헬스 체크 및 메트릭 엔드포인트 설정 방법을 설명합니다.

인스턴스 상태를 확인하기 위해 호출할 수 있는 세 가지 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 환경 변수를 사용하여 인스턴스를 설정하는 방법에 대한 자세한 내용은 설정 방법 을 참조하세요.