可觀察性與故障排除

良好的 TokenLab 可觀察性始於公共識別碼。您的日誌應該幫助您回答「用戶請求了什麼，TokenLab 創建了什麼公共任務，以及如何計費？」而不暴露敏感供應商細節或敏感的用戶數據。

從請求詳情到調查與人工支援Copy Anchor Link

1. 在請求所屬工作區開啟請求記錄，依 Request ID 找到並選取記錄。

2. 開啟完整詳情進入獨立頁面；返回請求清單時會還原篩選。連結不會授予其他工作區的存取權，請使用已獲授權的帳戶。

3. 處理中或狀態未知時，先重新整理進度。明確失敗或接收中斷時，可按需啟動站內 Agent 調查該請求，不會重送原模型請求。正常成功的請求預設不需要調查。

4. 仍需協助時，從請求或調查選擇人工支援，先開啟預覽；可用時會關聯原請求和對話。核對摘要、移除私密內容，再明確提交。啟動調查或開啟預覽本身不會傳送客服請求。

5. 提交後保留確認回執，在支援中繼續同一對話、查看回覆及補充資訊，避免重複提交。

要捕獲的公共識別碼Copy Anchor Link

請勿將供應商任務 ID、供應商 URL、供應商識別碼、Redis 鍵或敏感執行元數據存儲為面向客戶的記錄。

要記錄的內容Copy Anchor Link

記錄足夠的信息以診斷請求而不洩漏秘密：

• 端點、HTTP 方法、模型、狀態碼、時間戳和延遲。
• 公共識別碼：request_id、task_id、poll_url 和 billing_transaction_id（如果存在）。
• 清理過的請求形狀：哪些字段存在，而不是完整的提示或私有媒體內容。
• 終端非同步狀態響應，包括公共錯誤字段。
• 客戶端重試計數以及重試是否創建了新任務或恢復了現有任務。

除非您獲得明確許可保留，否則始終隱去 Authorization、API 鍵、管理令牌、簽名 URL、私有媒體 URL、完整提示和用戶個人數據。

故障排除矩陣Copy Anchor Link

使用情況對帳Copy Anchor Link

使用管理 API 進行伺服器端對帳：

curl "https://api.tokenlab.sh/v1/management/api-keys/key_abc123def456/usage?page=1&limit=20&scene=video" \
  -H "Authorization: Bearer mt-your-management-token"

GET /v1/management/api-keys/{keyId}/usage 可以根據 scene、model、modelVendor、startDate 和 endDate 進行過濾。使用這些記錄，而不是抓取儀表板頁面或依賴供應商任務 ID。

串流響應可能在串流發送後結算，因此即使稍後記錄使用情況，計費標頭也可能缺失。非同步媒體任務可能在終端輪詢後結算。

支援包模板Copy Anchor Link

聯繫支援時，請包括：

• request_id。
• task_id 和 poll_url 用於非同步工作。
• billing_transaction_id（如果存在）。
• 端點、方法、模型、時間戳和狀態碼。
• 清理過的請求形狀和公共錯誤主體。
• 您的預期結果和用戶實際看到的內容。

除非 TokenLab 支援明確要求提供已隱去的範本，否則請勿包括 API 鍵、管理令牌、私有媒體、完整提示、供應商 URL、通道 ID 或私有調試識別碼。

操作檢查Copy Anchor Link

• 對重複的 401、402、429 和 5xx 響應分別發出警報；它們通常有不同的負責人。
• 跟踪在您的產品 SLA 內長時間保持非終端的非同步任務。
• 跟踪同一用戶工作 ID 的重複創建嘗試。
• 抽樣已完成的任務，並驗證用戶可見資產、使用記錄和存儲的任務記錄是否一致。

API 參考Copy Anchor Link