For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the public content index is available at https://we0.ai/llms.txt, and the English article bundle is available at https://we0.ai/llms-full.txt.
For AI agents: the complete content index is available at https://we0.ai/llms.txt, the full English article bundle is available at https://we0.ai/llms-full.txt, and this page is available as Markdown at https://we0.ai/zh-TW/articles/claude-opentelemetry-tracing-api-and-sdk-4adbbb12.md.
Anthropic 已為 Claude Managed Agents、Messages API 與 Claude SDK 推出 OpenTelemetry 追蹤匯出功能。此功能於 2026 年 10 月 14 日發布，目前為公開測試版，可將標準追蹤資料傳送至接受 OTLP 的可觀...
Anthropic 已為 Claude Managed Agents、Messages API 與 Claude SDK 推出 OpenTelemetry 追蹤匯出功能。此功能於 2026 年 10 月 14 日發布，目前為公開測試版，可將標準追蹤資料傳送至接受 OTLP 的可觀測性平台。
目標很實際：在呼叫 Agent 的應用程式脈絡中，追蹤 Agent 的模型呼叫與工具活動。團隊不必分別在不同位置調查延遲、失敗與 Token 用量，而是可在既有的可觀測性系統中檢視相關 Span。
**Trace（追蹤）**會記錄一次請求在系統中的路徑。**Span（跨度）**則記錄該路徑中的一項操作，例如模型呼叫或工具執行。Claude 的 Span 遵循 OpenTelemetry 的 GenAI 語意慣例，協助相容工具跨模型供應商解讀資料。
來源：Anthropic。此圖示範追蹤結構與分析工作流程，並非量測效能結果。
有兩種互補的資料蒐集方式：
| 功能 | SDK 追蹤 | API 追蹤 |
|---|---|---|
| 設定方式 | 應用程式程式碼與 Tracer Provider | Claude Console 目的地 |
| 特殊 Claude 權限 | 不需要 | 新增或變更目的地需要 Admin 角色 |
| 請求中的模型執行 | 僅靠 SDK 追蹤不會個別公開 | 包含 |
| Managed Agents 回合 | 僅靠 SDK 追蹤不會公開 | 包含 |
| 由 API 執行的工具 | 僅靠 SDK 追蹤不會公開 | 包含 |
| 由 SDK Tool Runner 執行的用戶端工具 | 包含 | 僅靠 API 追蹤不會擷取 |
| 自行託管沙箱中的工具 | 透過受支援的 SDK Worker 包含 | 僅靠 API 追蹤不會擷取 |
| 其他用戶端 API 操作，例如檔案上傳 | 包含 | 僅靠 API 追蹤不會擷取 |
兩種途徑都會記錄請求 Span 與 Token 用量。合併使用時，可同時掌握用戶端工作及 Claude API 內部執行的工作。將兩者傳送至同一個後端，也能讓後端呈現其關聯性。
API 追蹤不需要為了接收獨立的 API Trace 而變更一般請求程式碼。管理員只需新增一個目的地，指定 Claude 應將資料傳送至何處。
anthropic.test Span。service.name = claude-platform。對於自訂目的地，文件規定必須是可在連接埠 443 的 HTTPS 主機名稱上接受 protobuf 的 OTLP/HTTP 端點。僅在常用連接埠 4318 監聽的 Collector，需要適當的 HTTPS 對外暴露方式或反向 Proxy。認證憑證應放在標頭值中。
基礎端點通常不包含 /v1/traces，因為 Claude 會自行附加該路徑。進階 traces 端點可以覆寫路徑，但必須使用相同主機。私有位址端點與重新導向不支援作為一般傳送目的地。
SDK 追蹤的起點，是安裝目前受支援的 Claude SDK，並在第一次要追蹤的呼叫前註冊 OpenTelemetry Tracer Provider。應用程式需提供將 Span 傳送至可觀測性後端的 Exporter。因此，「自動 SDK 匯出」不代表新應用程式在沒有 Tracer Provider 與目的地 Exporter 的情況下，就會自動把資料傳送到某處。
在連接遠端平台前，Console Exporter 可協助檢查本機 Instrumentation。完成設定後，SDK 會發出請求 Span，以及透過其 Tool Runner 執行工具的 Span。在應用程式 Span 內進行的呼叫，可以巢狀顯示於該 Span 之下。
測試版期間，SDK 選項、Span 名稱與屬性可能會變動。Anthropic 建議固定 SDK 版本，讓團隊能自行決定何時採用這些變更。
SDK 會傳播 Trace Context，使 API 的伺服器端 Span 可位於 SDK 用戶端 Span 下方。Claude Platform on AWS 的請求是例外：其 API Span 會出現在各自獨立的 Trace 中，因為該平台尚未支援相同的 Trace Context 串接行為。
Managed Agents 工作階段會公開 Sessions API 請求 Span、Agent 回合 Span、模型請求、由 API 執行的工具，以及結果評估。一個工作階段可跨越多個 Trace，並且在多 Agent 運作時跨越多個執行緒。文件建議使用 anthropic.session.id 對工作階段分組，或使用 gen_ai.conversation.id 對執行緒分組。
Claude Code、Agent SDK 與 Cowork 各自都有監控文件。新的平台功能不應被視為可取代各項產品既有 Instrumentation 說明的方案。
每個 Console 目的地與 SDK 用戶端都有內容模式。預設的 Metadata only 包含識別碼、時間資訊、狀態、Token 計數，以及工具名稱、工具說明與 MCP 伺服器名稱等選定描述文字。它不包含模型 Prompt 與回應，但也不保證每個匯出欄位都不含應用程式提供的文字。
Full content 也包含 Prompt 與回應。這使其適合用於偵錯失敗互動，以及根據真實流量建立評估，但也會將對話內容傳送至另一套具有自身存取與保留設定的系統。
預設內容限制為每個 Span 0.75 MB。Anthropic 表示，這大約可容納 200,000 Token 的英文 Context，並低於許多可觀測性服務與 Proxy 使用的 1 MB 請求限制。完整的一百萬 Token Context 可能需要約 4 MB，因此預設值不足以完整保留每一個大型 Prompt。
當 Span 超過內容限制時，SDK 或 API 會將其縮短，並將 anthropic.content.truncated 設為 true。請求 Span 會優先捨棄 System Prompt 與最早的訊息；工具 Span 則會從工具結果的末端捨棄區塊。圖片與文件會依類型呈現，而非包含完整媒體承載資料。
SDK 使用 traces.max_content_bytes 控制限制。Console 目的地會在進階設定中提供最大內容大小，而列出的供應商可能有供應商專屬的預設值。
輸入一句想法，We0 AI 即可生成展示站、頁面與 CMS。發佈上線後並幫你獲取客戶和流量。
用戶註冊贈送一次完整項目生成
適合先體驗一次完整生成流程，快速看到專案初稿。
與 Anthropic 具有 HIPAA、FERPA 或 K–12 資料處理限制的組織，無論選擇何種內容模式，均僅能透過 API 目的地匯出中繼資料。文件指出，此限制不適用於 SDK Span，因此 SDK 設定仍需要另行審查。
符合資格的零資料保留 Messages API 請求可使用完整內容匯出，因為 API 在傳送前僅將匯出內容保留在記憶體中。Managed Agents 不符合零資料保留資格，而啟用 OpenTelemetry 並不會改變其保留條款。
一次請求可能會將其 Token 用量放在多個 Span 中。因此，對 Trace 中每個 Span 的數值加總，可能高估用量。
當 Messages API 請求同時存在 SDK 與 API Span 時，請使用 API 來源。在該來源中，應加總請求 Span 或其模型請求 Span，而非兩者同時加總；並依文件的特定規則處理 Compaction。對 Managed Agents 而言，相關的 API Span 是模型請求與結果評估。
傳送重試也可能產生重複 Span。若後端尚未處理，請使用 Trace ID 與 Span ID 去除重複資料。
**匯出的 Trace 是除錯記錄，不是保證完整的計費帳本。**傳送採盡力而為方式，取樣也可能略過請求。對於需要完整 API Key 用量追蹤的團隊，Anthropic 建議使用 Usage API。
Anthropic 列舉 Grafana Cloud、Honeycomb、Sentry 與 Splunk，可用於在應用程式日誌與指標旁檢視 Agent Trace。它也列出 Arize AI、Braintrust、Datadog、Langfuse、LangSmith、New Relic 與 PostHog，適用於將 Trace 與評估及品質改善串連的工作流程。Databricks Unity Gateway 則被強調可提供組織層級的可見性。
這些是範例，並非唯一的相容清單。只要其他工具接受所需的標準 OTLP 匯出，也能接收這些資料。
公告包含 Foxglove、Ramp、Sterling Labs 與 FloQast 的客戶陳述。其使用案例涵蓋機器人除錯、分析市場 Agent，以及追蹤會計工作流程。
Ramp 描述一套名為 Reflect 的內部系統，該系統會評分 Langfuse Trace 並提出修正建議。其工程師表示，部分 Agent 的 Token 用量降低 10–20%，工作階段速度提升 30%。這些是該改善工作流程的客戶回報結果；並不代表僅啟用 Trace 匯出便能保證取得這些改善。
它會將描述 Claude API 請求、Agent 回合、模型呼叫及受支援工具活動的標準 Span 傳送至可觀測性後端。此功能目前為公開測試版，並支援獨立的 API 與 SDK 追蹤途徑。
您需要 Admin 角色才能在 Claude Console 新增或變更 API 追蹤目的地。SDK 追蹤是在應用程式程式碼中設定，且不需要特殊的 Claude 組織權限。
不會，預設模式為 Metadata only。Full content 會加入 Prompt 與回應，但仍受內容大小限制，以及特定組織的已記錄限制所約束。
可以，前提是 API 目的地符合已記錄的網路與通訊協定要求。具體而言，API 匯出需要可透過連接埠 443 的公開 HTTPS 主機名稱存取、且能接收 OTLP/HTTP protobuf 的 Receiver，而不能只有私有的 Collector Listener。
可以，前提是 Trace Context 已傳播，且 Span 傳送至同一個可觀測性後端。目前，發送至 Claude Platform on AWS 的請求，其 API Span 則會出現在獨立的 Trace 中。
不可以，Trace 可能被取樣、遺失或重複傳送。請依據文件的計算規則進行分析；如需完整用量核算，請使用 Usage API。
Claude 的 OpenTelemetry 測試版可將模型呼叫與 Agent 工具連接至團隊既有使用的追蹤系統。API 追蹤公開伺服器端活動，而 SDK 追蹤補足用戶端操作與工具；在支援 Trace 串接時，結合兩者能提供最清晰的應用程式時間線。
請審慎選擇內容模式、檢查截斷與傳送健康狀態，並從單一適當來源計算 Token。追蹤可改善可見性，但完整用量核算與資料保留控管仍是獨立責任。
從一句話開始，幾分鐘內拿到完整網站。
