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

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

export N8N_METRICS=true

노출할 메트릭과 레이블을 구성하려면 해당 환경 변수 (N8N_METRICS_INCLUDE_*)를 참조하세요.

main과 worker 인스턴스 모두 메트릭을 노출할 수 있습니다.

큐 메트릭#

큐 메트릭을 활성화하려면 N8N_METRICS_INCLUDE_QUEUE_METRICS 환경 변수를 true로 설정하세요. N8N_METRICS_QUEUE_METRICS_INTERVAL로 새로 고침 속도를 조정할 수 있습니다.

n8n은 Bull에서 이러한 메트릭을 수집하여 메인 인스턴스에 노출합니다. 멀티 메인 설정에서 쿼리를 집계할 때 instance_role_leader 게이지를 사용하여 리더를 식별할 수 있으며, 리더 메인은 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