OpenTelemetry 环境变量(OpenTelemetry environment variables)

File-based configuration

You can add _FILE to individual variables to provide their configuration in a separate file. Refer to Keeping sensitive data in separate files for more details.

n8n 可以通过 OTLP 将工作流和节点执行跟踪导出到 OpenTelemetry 收集器。有关详细信息，请参阅 OpenTelemetry 跟踪。

🌐 n8n can export workflow and node execution traces over OTLP to an OpenTelemetry collector. Refer to OpenTelemetry tracing for details.

| 变量 | 类型 | 默认值 | 描述 | 可用自 |

| :------- | :--- | :------ | :---------- | :------

| N8N_OTEL_ENABLED | 布尔值 | false | 是否启用 OpenTelemetry 跟踪。当设置为 false 时，n8n 不会加载 OpenTelemetry SDK。 | 2.19.0 |

| N8N_OTEL_EXPORTER_OTLP_ENDPOINT | 字符串 | http://localhost:4318 | 要将跟踪导出到的 OTLP HTTP 端点的基础 URL。n8n 应用会将 N8N_OTEL_EXPORTER_OTLP_TRACING_PATH 的值附加到此 URL。 | 2.19.0 |

| N8N_OTEL_EXPORTER_OTLP_TRACING_PATH | 字符串 | /v1/traces | 附加到 N8N_OTEL_EXPORTER_OTLP_ENDPOINT 的路径，用于导出追踪。 | 2.19.0 |

| N8N_OTEL_EXPORTER_OTLP_HEADERS | 字符串 | - | 以逗号分隔的 key=value 对列表，用于在每个 OTLP 请求中作为 HTTP 头发送。用于身份验证令牌或租户头。例如：authorization=Bearer <token>,x-tenant=acme。 | 2.19.0 |

| N8N_OTEL_EXPORTER_SERVICE_NAME | 字符串 | n8n | 导出跨度上 service.name 资源属性的值。 | 2.19.0 |

| N8N_OTEL_TRACES_SAMPLE_RATE | 数字 | 1.0 | 要导出的跟踪比例，在 0 和 1 之间。n8n 使用跟踪 ID 比例采样器，因此一个跟踪中的所有跨度要么一起被采样，要么一起被丢弃。 | 2.19.0 |

| N8N_OTEL_TRACES_INCLUDE_NODE_SPANS | 布尔值 | true | 是否为每次节点执行发出 node.execute span。设置为 false 仅导出工作流级别的 spans。 | 2.19.0 |

| N8N_OTEL_TRACES_INJECT_OUTBOUND | 布尔值 | true | 是否将 W3C traceparent/tracesstate 头注入使用 n8n HTTP 辅助工具的节点发出的出站 HTTP 请求中。 | 2.19.0 |

| N8N_OTEL_STARTUP_CONNECTIVITY_TIMEOUT_MS | 数字 | 2000 | 启动时对 OTLP 端点进行连接性检查的超时时间（以毫秒为单位）。如果在此期间无法访问端点，n8n 会记录警告。 | 2.19.0 |