Skip to content

启用 Prometheus 指标监控#

n8n 使用 prom-client 库来收集和暴露指标数据。

默认情况下 /metrics 端点处于禁用状态，但可以通过设置 N8N_METRICS 环境变量来启用它。

1
export N8N_METRICS=true

关于配置需要暴露哪些指标和标签，请参考相应的环境变量 (N8N_METRICS_INCLUDE_*)。

无论是 main 主实例还是 worker 工作实例都可以暴露指标数据。

队列指标#

要启用队列指标监控，需将 N8N_METRICS_INCLUDE_QUEUE_METRICS 环境变量设为 true。您可以通过 N8N_METRICS_QUEUE_METRICS_INTERVAL 来调整刷新频率。

队列指标仅在单主模式下的 main 主实例中可用。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
# HELP n8n_scaling_mode_queue_jobs_active 扩展模式下所有工作节点当前正在处理的作业数量。

# TYPE n8n_scaling_mode_queue_jobs_active gauge
n8n_scaling_mode_queue_jobs_active 0


# HELP n8n_scaling_mode_queue_jobs_completed 实例启动以来，扩展模式下所有工作节点完成的作业总数。

# TYPE n8n_scaling_mode_queue_jobs_completed counter
n8n_scaling_mode_queue_jobs_completed 0


# HELP n8n_scaling_mode_queue_jobs_failed 实例启动以来，扩展模式下所有工作节点失败的作业总数。

# TYPE n8n_scaling_mode_queue_jobs_failed counter
n8n_scaling_mode_queue_jobs_failed 0


# HELP n8n_scaling_mode_queue_jobs_waiting 扩展模式下当前排队等待处理的作业数量。

# TYPE n8n_scaling_mode_queue_jobs_waiting gauge
n8n_scaling_mode_queue_jobs_waiting 0