New Relic

将追踪发送到 New Relic

New Relic 是用于监控应用、基础设施和数字体验的全栈可观测性平台。

第 1 步：获取 New Relic 许可证密钥

在 New Relic 中，前往 API 密钥页面：

1. 登录你的 New Relic 账户
2. 在账户设置中前往 API 密钥（API Keys）
3. 创建新的 Ingest - License key，或复制现有密钥

第 2 步：在 OpenRouter 中启用广播

前往 设置 > 可观测性（Settings > Observability），打开 启用广播（Enable Broadcast） 开关。

第 3 步：配置 New Relic

点击 New Relic 旁的编辑图标，并填写：

• License Key：你的 New Relic ingest license key
• Region：选择 New Relic 区域（us 或 eu）

第 4 步：测试并保存

点击 测试连接（Test Connection） 验证配置。仅当测试通过时才会保存配置。

第 5 步：发送测试追踪

通过 OpenRouter 发出一次 API 请求，然后在 New Relic 的 分布式追踪视图中查看该追踪。

自定义元数据

New Relic 通过 OTLP 协议接收追踪。trace 字段中的自定义元数据会作为 Span 属性发送。

支持的元数据键

示例

{
  "model": "openai/gpt-4o",
  "messages": [{ "role": "user", "content": "Summarize this report..." }],
  "user": "user_12345",
  "session_id": "session_abc",
  "trace": {
    "trace_id": "workflow_789",
    "trace_name": "Report Processing",
    "generation_name": "Summarize Report",
    "environment": "production",
    "service": "report-api"
  }
}

在 New Relic 中查看

在 New Relic 的分布式追踪视图中，你可以：

• 使用 NRQL 查询按自定义属性筛选追踪
• 在 Span 属性面板中查看自定义元数据
• 基于元数据字段创建告警和仪表盘

补充说明

• trace 中的自定义元数据键会作为 Span 属性包含在 trace.metadata.* 命名空间下
• user 字段会映射到 Span 属性中的 user.id
• session_id 字段会映射到 Span 属性中的 session.id
• 模型、Token 和费用数据使用 GenAI 语义约定（gen_ai.* 属性）

隐私模式

当该目标端启用 隐私模式 时，追踪中会排除提示词和补全内容。其余追踪数据——Token 用量、费用、时间信息、模型信息以及自定义元数据——仍会正常发送。详情见 隐私模式。