Raindrop

将追踪发送到 Raindrop

Raindrop 是用于监控和评估 LLM 应用的 AI 可观测性平台。借助 Raindrop，你可以跟踪对话、分析模型表现并调试 AI 工作流。

第 1 步：获取 Raindrop 写入密钥

在 Raindrop 中，前往项目设置：

1. 登录你的 Raindrop 账户
2. 前往 设置（Settings） 并找到项目的 写入密钥（Write Key）
3. 复制写入密钥

第 2 步：在 OpenRouter 中启用广播

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

第 3 步：配置 Raindrop

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

• Write Key：你的 Raindrop 项目写入密钥
• Base URL（可选）：默认为 https://api.raindrop.ai。仅在使用自定义端点时修改

第 4 步：测试并保存

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

第 5 步：发送测试追踪

通过 OpenRouter 发出一次 API 请求，然后在 Raindrop 控制台的 事件（Events） 下查看该事件。

每个事件包含：

• 用户输入（User Input）：对话中最新的用户消息
• 助手输出（Assistant Output）：模型的补全文本
• 属性（Properties）：Token 计数、费用、延迟、模型、模型服务提供商以及结束原因

自定义元数据

Raindrop 接收的事件会将自定义元数据作为事件属性包含在内。使用 trace 字段可为事件附加额外上下文。

支持的元数据键

示例

{
  "model": "anthropic/claude-sonnet-4",
  "messages": [{ "role": "user", "content": "What time is it?" }],
  "user": "user_35",
  "session_id": "session_abc",
  "trace": {
    "trace_name": "Time Check",
    "feature": "assistant"
  }
}

trace 中不在上表内的每个键都会原样转发（例如 feature 会成为属性 feature）。

补充说明

• user 字段会映射到 Raindrop 的 user_id，用于用户级分析
• session_id 字段会映射到 convo_id，用于归组对话轮次
• 事件包含 model、provider、total_cost、prompt_tokens、completion_tokens、duration_ms 和 finish_reason 等系统属性

隐私模式

当该目标端启用 隐私模式 时，事件中会排除 input 和 output 字段。其余事件数据——Token 用量、费用、时间信息、模型信息以及自定义元数据——仍会正常发送。详情见 隐私模式。