OpenTelemetry 环境变量#
基于文件的配置
您可以在单个变量后添加 _FILE 以在单独的文件中提供其配置。有关更多详细信息，请参阅在单独文件中保存敏感数据。
n8n 可以通过 OTLP 将工作流与节点执行追踪导出到 OpenTelemetry collector。详情请参阅 OpenTelemetry 追踪。
| 变量 | 类型 | 默认值 | 说明 | 支持版本 |
|---|---|---|---|---|
N8N_OTEL_ENABLED |
Boolean | false |
是否启用 OpenTelemetry 追踪。设为 false 时，n8n 不会加载 OpenTelemetry SDK。 |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_ENDPOINT |
String | http://localhost:4318 |
用于导出追踪的 OTLP HTTP 端点基础 URL。n8n 会把 N8N_OTEL_EXPORTER_OTLP_TRACING_PATH 的值追加到该 URL 后。 |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_TRACING_PATH |
String | /v1/traces |
用于导出追踪时追加到 N8N_OTEL_EXPORTER_OTLP_ENDPOINT 后的路径。 |
2.19.0 |
N8N_OTEL_EXPORTER_OTLP_HEADERS |
String | - | 每次 OTLP 请求都会附带的 HTTP 头，格式为逗号分隔的 key=value 列表。可用于认证 token 或租户头。例如：authorization=Bearer <token>,x-tenant=acme。 |
2.19.0 |
N8N_OTEL_EXPORTER_SERVICE_NAME |
String | n8n |
导出 span 上 service.name 资源属性的值。 |
2.19.0 |
N8N_OTEL_TRACES_SAMPLE_RATE |
Number | 1.0 |
要导出的追踪比例，取值范围为 0 到 1。n8n 使用 trace ID 比例采样器，因此同一条追踪中的所有 span 会一起被采样或一起被丢弃。 |
2.19.0 |
N8N_OTEL_TRACES_INCLUDE_NODE_SPANS |
Boolean | true |
是否为每次节点执行发出一个 node.execute span。设为 false 时，仅导出工作流级 span。 |
2.19.0 |
N8N_OTEL_TRACES_INJECT_OUTBOUND |
Boolean | true |
是否向使用 n8n HTTP helper 的节点所发出的出站 HTTP 请求中注入 W3C traceparent/tracesstate 头。 |
2.19.0 |
N8N_OTEL_STARTUP_CONNECTIVITY_TIMEOUT_MS |
Number | 2000 |
启动时对 OTLP 端点进行连通性检查的超时时间（毫秒）。如果在该时间内无法访问端点，n8n 会记录一条警告。 | 2.19.0 |