n8n은 지표를 수집하고 노출하기 위해 prom-client 라이브러리를 사용합니다.

/metrics 엔드포인트는 기본적으로 비활성화되어 있지만, N8N_METRICS 환경 변수를 사용하여 활성화할 수 있습니다.

export N8N_METRICS=true

노출할 지표와 레이블을 구성하는 방법은 해당 환경 변수(N8N_METRICS_INCLUDE_*)를 참고하세요.

main 인스턴스와 worker 인스턴스 모두 지표를 노출할 수 있습니다.

Grafana를 Prometheus에 연결하여 n8n 지표를 시각화하는 방법은 Grafana를 참고하세요.

큐 지표#

큐 지표를 활성화하려면 N8N_METRICS_INCLUDE_QUEUE_METRICS 환경 변수를 true로 설정하세요. N8N_METRICS_QUEUE_METRICS_INTERVAL을 사용하여 갱신 주기를 조정할 수 있습니다.

n8n은 Bull에서 이러한 지표를 수집하여 main 인스턴스에 노출합니다. 멀티 메인(multi-main) 구성에서 쿼리를 집계할 때는 instance_role_leader 게이지를 사용하여 리더를 식별할 수 있습니다. 리더 main은 1로 설정되고, 그렇지 않은 경우 0으로 설정됩니다.

# HELP n8n_scaling_mode_queue_jobs_active Current number of jobs being processed across all workers in scaling mode.
# TYPE n8n_scaling_mode_queue_jobs_active gauge
n8n_scaling_mode_queue_jobs_active 0

# HELP n8n_scaling_mode_queue_jobs_completed Total number of jobs completed across all workers in scaling mode since instance start.
# TYPE n8n_scaling_mode_queue_jobs_completed counter
n8n_scaling_mode_queue_jobs_completed 0

# HELP n8n_scaling_mode_queue_jobs_failed Total number of jobs failed across all workers in scaling mode since instance start.
# TYPE n8n_scaling_mode_queue_jobs_failed counter
n8n_scaling_mode_queue_jobs_failed 0

# HELP n8n_scaling_mode_queue_jobs_waiting Current number of enqueued jobs waiting for pickup in scaling mode.
# TYPE n8n_scaling_mode_queue_jobs_waiting gauge
n8n_scaling_mode_queue_jobs_waiting 0