准备工作
开始前,请准备:- 一个可用的 AIHubMix API Key
- 一个 LangWatch 账号和目标 Project
- AIHubMix 控制台的访问权限
- 获取 LangWatch Project API Key
- 登录 LangWatch,选择用于接收 AIHubMix Trace 的 Project。
- 打开 Settings → API Keys。
- 找到 Project API Key。确认其 Scope 是目标 Project,然后点击复制按钮。

- 添加 LangWatch 目的地
- 打开 AIHubMix 可观测性。
- 在 Add destination 下点击 LangWatch。

- 填写配置:
x-session-id 请求头和请求中的 user 字段会随记录传递,可用于在 LangWatch 中关联会话或用户。

测试并保存
- 点击 Test。连接成功后,按钮会显示 Connected。
- 点击 Add destination 保存新目的地。
- 确认目的地开关已开启,状态显示为 OK。

- 发送验证请求
确认当前 shell 已设置 AIHUBMIX_API_KEY 环境变量,然后发送一次正常模型请求:
cURL
记录采用异步投递。请求完成后,Trace 可能需要数秒才会出现在 LangWatch。
- 在 LangWatch 中验证
- 打开目标 Project 的 Traces 页面。
- 查找刚才请求使用的模型,或通过
x-session-id、user字段定位记录。 - 确认记录包含耗时、成本、token 和模型信息。


常见问题
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