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 |