n8n 中文文档

OpenTelemetry环境变量

提示

File-based configuration 基于文件的配置

您可以将 _FILE 添加到各个变量,以在单独的文件中提供其配置。有关更多详细信息,请参阅将敏感数据保存在单独的文件中。

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

变量 类型 默认值 说明 支持版本
N8N_OTEL_ENABLED 布尔 false 是否启用 OpenTelemetry 跟踪。当设置为 false 时,n8n 不会加载 OpenTelemetry SDK。 2.19.0
N8N_OTEL_EXPORTER_OTLP_ENDPOINT 字符串 http://localhost:4318 要将跟踪导出到的 OTLP 端点的基础 URL。该值必须是 http:// 或 https:// URL,否则 n8n 会记录警告并使用默认值。使用 http/protobuf 时,n8n 会将 N8N_OTEL_EXPORTER_OTLP_TRACING_PATH 的值附加到此 URL。 2.19.0
N8N_OTEL_EXPORTER_OTLP_PROTOCOL 字符串 http/protobuf 用于导出跟踪的 OTLP 传输协议。有效值为 http/protobuf 和 grpc。变量名称和值与上游 OTEL_EXPORTER_OTLP_PROTOCOL 规范一致。有关选择建议,请参阅选择 OTLP 协议。 2.39.0
N8N_OTEL_EXPORTER_OTLP_TRACING_PATH 字符串 /v1/traces 附加到 N8N_OTEL_EXPORTER_OTLP_ENDPOINT、用于导出跟踪的路径。当 N8N_OTEL_EXPORTER_OTLP_PROTOCOL 为 grpc 时,n8n 会忽略此变量,因为 gRPC 端点不带 URL 路径。 2.19.0
N8N_OTEL_EXPORTER_OTLP_HEADERS 字符串 - 以逗号分隔的 key=value 对列表,作为 HTTP 标头与每个 OTLP 请求一起发送。可用于身份验证 token 或租户标头。例如:authorization=Bearer <token>,x-tenant=acme。使用 grpc 协议时,n8n 会将这些值作为 gRPC metadata 发送,并将 key 转换为小写。 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 跨度。设置为 false 以仅导出工作流级别跨度。 2.19.0
N8N_OTEL_TRACES_CUSTOM_ATTRIBUTE_PREFIXES String - 用于更改或移除自定义跨度属性键前缀的 JSON 对象,例如 {"project":"","node":""}。请参阅更改属性前缀。 2.46.0
N8N_OTEL_TRACES_EMIT_WORKFLOW_START_SPAN Boolean false 是否在工作流执行开始时发送一个持续时间为 0 毫秒的 workflow.execute.started 跨度。请参阅启动跨度。 2.44.0
N8N_OTEL_TRACES_EMIT_NODE_START_SPAN Boolean false 是否在节点执行开始时发送一个持续时间为 0 毫秒的 node.execute.started 跨度。需要将 N8N_OTEL_TRACES_INCLUDE_NODE_SPANS 设为 true。请参阅启动跨度。 2.44.0
N8N_OTEL_TRACES_PRODUCTION_ONLY 布尔值 true 是否仅导出生产执行 的跟踪。设为 false 可导出所有工作流执行的跟踪。 2.25.2
N8N_OTEL_TRACES_INJECT_OUTBOUND 布尔 true n8n 是否向使用 n8n HTTP 帮助程序的节点发出的出站 HTTP 请求添加跟踪标头。为 true 时,n8n 会发送 traceparent、tracestate 和 baggage(从 n8n 2.47.0 起)。可使用 OTEL_PROPAGATORS 缩小发送范围。请参阅出站跟踪标头。 2.19.0
OTEL_PROPAGATORS 字符串 tracecontext,baggage 以逗号分隔的列表,指定 N8N_OTEL_TRACES_INJECT_OUTBOUND 为 true 时 n8n 写入哪些标头。有效名称:tracecontext(发送 traceparent 和 tracestate)、baggage 和 none。设置为 tracecontext 可阻止 n8n 将调用方的 baggage 条目转发到下游。n8n 只在启动时读取一次此变量,因此更改后需要重启。请参阅出站跟踪标头。 2.47.0
N8N_OTEL_STARTUP_CONNECTIVITY_TIMEOUT_MS 数量 2000 针对 OTLP 端点进行启动连接检查的超时(以毫秒为单位)。如果在此期间无法访问端点,n8n 会记录错误。 2.19.0
N8N_AGENTS_TRACING_ENABLED 布尔 true agent runs 是否发出 OpenTelemetry spans。继承 N8N_OTEL_* 的 endpoint、headers、sampling 和 transport 设置。配置 OTel provider 前 spans 无处发送;如果只想运行 workflow tracing 而不包含 agent spans,请将其设置为 false。 2.33.0
N8N_AGENTS_TRACING_RECORD_INPUTS 布尔 true agent tracing 是否记录 inputs,例如 prompts 和 tool arguments。设置为 false 可从 traces 中排除敏感 input data。 2.33.0
N8N_AGENTS_TRACING_RECORD_OUTPUTS 布尔 true agent tracing 是否记录 outputs,例如 responses 和 tool results。设置为 false 可从 traces 中排除敏感 output data。 2.33.0

相关资源

不想自己部署和维护 n8n?n8ncn 托管 n8n 云服务:开通账号即可使用,不用买服务器;也可以在 n8ncn 工作流库 找现成的中文工作流。