Skip to main content
Broadcast 可将 AIHubMix API 请求的 Trace 自动发送到已配置的外部可观测性平台。无需在应用代码中添加额外埋点,即可在 LangWatch 中监控、调试和分析 LLM 使用情况。 AIHubMix 当前支持将 LangWatch 配置为 Broadcast 目的地。配置完成后,可以在 LangWatch 中查看模型、token 用量、实际计费成本、耗时、会话和 Trace 信息。

准备工作

开始前,请准备:
  • 一个可用的 AIHubMix API Key
  • 一个 LangWatch 账号和目标 Project
  • AIHubMix 控制台的访问权限
此集成需要目标 Project 下现成的 Project API Key,其格式为 sk-lw-*。组织或团队范围的密钥,以及 Personal OTLP Endpoint 使用的 pkey_*,不适用于此配置。AIHubMix 当前使用 LangWatch 官方云端地址,不支持自托管实例。

  1. 获取 LangWatch Project API Key

  1. 登录 LangWatch,选择用于接收 AIHubMix Trace 的 Project。
  2. 打开 Settings → API Keys
  3. 找到 Project API Key。确认其 Scope 是目标 Project,然后点击复制按钮。
无需创建新的 Secret Key。AIHubMix 使用该 Project 自带的 Project API Key。
LangWatch Settings 页面中的 Project API Key

  1. 添加 LangWatch 目的地

  1. 打开 AIHubMix 可观测性
  2. Add destination 下点击 LangWatch
AIHubMix Observability 页面中的 LangWatch 目的地
  1. 填写配置:
x-session-id 请求头和请求中的 user 字段会随记录传递,可用于在 LangWatch 中关联会话或用户。
AIHubMix 的 LangWatch 目的地配置表单

测试并保存

  1. 点击 Test。连接成功后,按钮会显示 Connected
  2. 点击 Add destination 保存新目的地。
  3. 确认目的地开关已开启,状态显示为 OK
后续修改配置时,点击 Save changes 保存。
AIHubMix 中状态为 OK 的 LangWatch 目的地

  1. 发送验证请求

确认当前 shell 已设置 AIHUBMIX_API_KEY 环境变量,然后发送一次正常模型请求:
cURL
记录采用异步投递。请求完成后,Trace 可能需要数秒才会出现在 LangWatch。

  1. 在 LangWatch 中验证

  1. 打开目标 Project 的 Traces 页面。
  2. 查找刚才请求使用的模型,或通过 x-session-iduser 字段定位记录。
  3. 确认记录包含耗时、成本、token 和模型信息。
LangWatch Traces 页面中的 AIHubMix 调用记录
启用 Privacy 后,Prompt 等内容列显示为空,但耗时、成本、token 和模型信息仍会保留。
启用 Privacy 后 LangWatch 中为空的内容列

常见问题

Test 返回 401

确认使用的是目标 Project 下的 Project API Key。不要使用 Personal OTLP Endpoint 的 pkey_*,也不要使用组织或团队范围密钥。

保存成功但没有 Trace

依次检查:
  • 目的地开关是否已开启,状态是否为 OK
  • Sampling rate 是否大于 0%
  • 如果设置了 Only forward these API keys,请求是否使用了已选择的 AIHubMix API Key
  • 请求完成后是否等待数秒并刷新 LangWatch Traces 页面

Privacy 是否影响统计数据

Privacy 只停止发送 prompt 和 completion 内容。token 用量、实际计费成本、耗时和模型信息仍会发送。
更新时间:2026-08-25