準備工作
- 一個可用的 AIHubMix API Key
- 一個 LangWatch 帳號和目標 Project
- AIHubMix 控制台的存取權限
- 取得 LangWatch Project API Key
- 登入 LangWatch,選擇用於接收 AIHubMix Trace 的 Project。
- 開啟 Settings → API Keys。
- 找到 Project API Key。確認其 Scope 是目標 Project,然後選擇複製按鈕。

- 新增 LangWatch 目的地
- 開啟 AIHubMix Observability。
- 在 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%,以及 API Key 篩選包含請求使用的 Key。等待數秒後重新整理 Traces。
Privacy 是否影響統計資料
Privacy 只停止傳送 prompt 和 completion 內容。token 用量、實際計費成本、耗時和模型資訊仍會傳送。更新時間:2026-08-25