启用 Prometheus 指标

为了收集并暴露指标，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 中收集这些指标，并在主实例（main instance）上暴露。在多主节点（multi-main）架构中，当进行指标聚合查询时，可通过 `instance_role_leader` 这个 gauge 指标识别领导者节点：领导者为 `1`，其他节点为 `0`。

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

| ```
# HELP n8n_scaling_mode_queue_jobs_active 在扩展模式下，当前所有 worker 正在处理的任务数量。
# TYPE n8n_scaling_mode_queue_jobs_active gauge
n8n_scaling_mode_queue_jobs_active 0

# HELP n8n_scaling_mode_queue_jobs_completed 自实例启动以来，在扩展模式下所有 worker 已完成的任务总数。
# TYPE n8n_scaling_mode_queue_jobs_completed counter
n8n_scaling_mode_queue_jobs_completed 0

# HELP n8n_scaling_mode_queue_jobs_failed 自实例启动以来，在扩展模式下所有 worker 处理失败的任务总数。
# 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

---|---

启用 Prometheus 指标

On this page