OpenTelemetry Collector 目的地支持将 OpenRouter trace 发送到任何支持 OTLP over HTTP 的后端，包括 Axiom、Jaeger、Grafana Tempo、Honeycomb、Lightstep 以及自托管 OpenTelemetry Collector。只需配置 OTLP traces endpoint URL 和可选的认证 Header（JSON 格式）即可。通过 trace 字段传入的自定义元数据以 span attributes 形式随 OTLP payload 发送，trace.metadata.* 命名空间下可查询。

OpenTelemetry 是用于收集、处理和导出遥测数据的开源可观测性框架。通过 OpenRouter Broadcast 的 OpenTelemetry Collector 目的地，可以将 trace 发送到任何支持 OTLP 协议的后端。

配置步骤

第一步：获取 OTLP endpoint 和凭证

对于 Axiom：

1. 创建 Axiom 账号和 dataset
2. 进入 Settings > API Tokens 创建新 token
3. Endpoint：https://api.axiom.co/v1/traces
4. 需要的 Headers：Authorization: Bearer xaat-xxx 和 X-Axiom-Dataset: your-dataset

对于自托管 Collector：

1. 部署带 OTLP receiver 的 OpenTelemetry Collector
2. 配置 receiver 监听公开可访问的 endpoint（通常以 /v1/traces 结尾）

第二步：在 OpenRouter 开启 Broadcast

前往 Settings > Observability，打开 Enable Broadcast 开关。

第三步：配置 OpenTelemetry Collector

点击 OpenTelemetry Collector 旁边的编辑图标，填写：

字段	填写内容
Endpoint	OTLP traces endpoint URL（如 https://api.axiom.co/v1/traces）
Headers（可选）	认证 Header，JSON 对象格式

Axiom Header 示例：

{
  "Authorization": "Bearer xaat-your-token",
  "X-Axiom-Dataset": "your-dataset"
}

第四步：测试并保存

点击 Test Connection 验证配置，测试通过后自动保存。

第五步：发送测试 Trace

通过 OpenRouter 发送 API 请求，在你的 OTLP 后端查看 trace。

兼容后端

OpenTelemetry Collector 目的地支持任何接受 OTLP over HTTP 的后端，包括：

后端	说明
Axiom	云原生日志与 trace 管理
Jaeger	分布式追踪平台
Grafana Tempo	高扩展性分布式追踪后端
Honeycomb	分布式系统可观测性
Lightstep	云原生可观测性平台
自托管 OTEL Collector	将 trace 路由到多个后端

OpenRouter 使用 OTLP/HTTP 协议配合 JSON 编码发送 trace。确保你的 Collector 或后端配置了接受 /v1/traces 路径上的 OTLP over HTTP 请求。

元数据映射

键	OTLP 映射	说明
trace_id	Trace ID	将多个请求归入同一 trace
trace_name	Span Name	根 span 的自定义名称
span_name	Span Name	中间 span 的名称
generation_name	Span Name	LLM 生成 span 的名称
parent_span_id	Parent Span ID	链接到已有 span

自定义元数据键存储在 trace.metadata.* 命名空间下。例如，trace 字段中的 environment 在 OTLP payload 中变为 trace.metadata.environment。

字段说明：

• user 映射到 user.id
• session_id 映射到 session.id
• 使用 parent_span_id 可将 OpenRouter trace 嵌套到现有应用分布式 trace 中

Privacy Mode

当为此目的地开启 Privacy Mode 时，prompt 和 completion 内容会从 trace 中排除。其他 trace 数据仍正常发送。

常见问题

Q: 和直接集成 Grafana、New Relic 等专用目的地相比，OpenTelemetry Collector 有什么优势？

A: OpenTelemetry Collector 目的地更通用，适合已有 OTEL 基础设施或需要支持不在专用目的地列表中的后端（如 Jaeger、Honeycomb）的场景。如果你使用的是有专用目的地的平台（如 Datadog、Grafana Cloud），建议优先使用专用目的地，通常有更好的字段映射和原生功能支持。

Q: 同一 OpenRouter 账号可以同时配置多个 OTLP 目的地吗？

A: 可以。Broadcast 支持同时配置多个目的地，每个目的地独立接收 trace。可以将同一 trace 同时发送到 Axiom 用于长期存储、发送到 Jaeger 用于实时调试。

Q: 如果 OTLP 后端暂时不可用，trace 会丢失吗？

A: Broadcast 是异步发送的，不影响主请求延迟。如果目的地暂时不可用，OpenRouter 不保证重试，可能会有少量 trace 丢失。对于关键监控，建议配置多个目的地或使用具有持久化能力的 Collector。