Claude Platform 開放 OpenTelemetry traces Beta：追蹤 API、Agent 與 SDK
Claude Platform 已開放 OpenTelemetry traces 公開 Beta，讓團隊將 Messages API、Claude Managed Agents 與 Claude SDK 的追蹤資料送到可接受 OTLP 的可觀測性平台。這能讓模型請求與工具呼叫等資訊出現在團隊既有的觀測工具中，方便排查執行狀況；功能依 Anthropic 的 Beta 條款提供。
一次請求如何變成可查的追蹤資料？
Trace 是一次請求在系統中的完整紀錄，span 則是其中的一個步驟，例如模型請求或工具呼叫。API 與 SDK 可以分別設定追蹤，也可以一起使用；一般情況下，兩者的 spans 能串在同一條 trace 中。若請求送往 Claude Platform on AWS，API spans 會位於各自獨立的 traces。
官方示範中，操作者在 Console 新增 OTLP 目的地、填入收集器端點與驗證標頭，再選擇內容模式和工作區範圍。追蹤資料可送往接受 OTLP 的觀測平台。
示範接著展示 Managed Agents 的一次執行：工作階段可拆成多個回合，每個回合再列出模型請求與工具呼叫及其耗時。操作者篩選錯誤狀態的 spans，並依 genai.tool.name 分組；畫面中的 querymetrics 範例列有成功項目與逾時項目。旁白稱約三分之一呼叫逾時，讓代理多做幾輪重試。這些是示範中的排查情境，不是 Claude Platform 整體的錯誤率或效能數據。
追蹤資料會包含哪些內容？
每個目的地與每個 SDK client 都有各自的內容模式，設定時分別選擇。預設的 metadata-only 模式會記錄識別資訊、時間、狀態、token 數，以及使用者選擇加入的文字，例如 agent 或工具名稱與描述；「僅中繼資料」不代表完全沒有文字。Full content 模式會額外包含模型提示與回覆。目的地平台會依自己的存取權限與保存設定管理這些內容。
內容模式決定 span 包含什麼；metadata-only 仍可能含使用者選定的文字。 組織資料政策可能讓目的地匯出僅含 metadata，即使已選 full-content；SDK spans 不受此限制。
Full content 的每個 span 預設最多包含 0.75 MB 內容；超過上限時，API 或 SDK 會截短內容並設定截短標記，圖片與文件只以類型呈現。若組織與 Anthropic 的資料處理限制涵蓋 HIPAA、FERPA 或 K–12，送往目的地的內容只會有 metadata，不受所選內容模式影響；這項限制不適用於 SDK spans。
使用 zero data retention 時，Messages API 匯出的內容只會在交付目的地前暫存於記憶體。Claude Managed Agents 不適用 zero data retention，啟用 OpenTelemetry 也不會改變它原有的資料保存方式。團隊應依資料類型、組織政策及目的地的存取與保存規則選擇內容模式。
Claude Platform OpenTelemetry Beta 示範：設定 OTLP 匯出目的地與驗證標頭、選擇內容模式，再檢視代理追蹤中的工具錯誤、執行內容與 Token 用量。
原文：https://easyvibecoding.app/curated/3448-claude-platform-opentelemetry-traces-beta
