Anthropic、Claude PlatformにOpenTelemetryのトレースエクスポート機能を追加

AnthropicはClaude PlatformにOpenTelemetryのトレースエクスポート機能を追加し、2026年10月14日、開発者がClaude Managed Agents、Messages API、Claude SDKから、標準規格に対応するあらゆる可観測性ツールへトレースを送信できるようになったと発表した。この機能はパブリックベータとして提供されている。

Anthropicの発表によると、Claude Consoleで送信先を追加すると、エージェントの各ターン、モデル呼び出し、ツールの使用がすべて、レイテンシ、トークン数、IDを含む標準的なOpenTelemetryトレースとして、ユーザーの可観測性ツールに送られる。Managed AgentsとMessages APIではConsoleでの送信先設定が必要だが、Claude SDKはトレースを自動的にエクスポートする。すでにClaude CodeやCoworkのトレースを可観測性ツールに送信している開発者は、Claude Platform上で構築したエージェントも同じ場所に表示できる。

Anthropicによると、ClaudeのトレースはOpenTelemetryのGenAIセマンティック規約に準拠しているため、Claudeや他のプロバイダーのデータを同じツールやダッシュボードで扱える。また、標準のOTLPエンドポイントに対応するOpenTelemetryツールであれば、どれでもトレースを利用できる。

2つの設定方法と共通のトレースモデル

Claude Platformのドキュメントでは、トレースをシステム内の1つのリクエストに関する全記録、スパンをトレース内の1つの処理ステップと定義している。スパンの例として、モデルへのリクエストやツールの使用が挙げられている。設定方法は2つある。SDKによるトレースは、SDKをインストールしてトレーサープロバイダーを登録することでコード内に設定でき、特別な権限は必要ない。APIによるトレースは、Claude Consoleで送信先を追加して設定し、管理者権限が必要となる。

2つの方法では、取得できる情報が異なる。APIによるトレースでは、リクエスト内の各モデル実行、Managed Agentsの各ターン、APIが実行するサーバーツールが記録される。SDKによるトレースでは、ツールランナーが実行するクライアントツール、セルフホスト型サンドボックス内のツール、ファイルのアップロードなど、その他のAPIリクエストも記録される。両方を設定すると、1つのリクエストに含まれるSDKとAPIのスパンが単一のトレースにまとめられる。ただし、AWS上のClaude Platformへのリクエストでは、APIのスパンは別個のトレースとして記録される。

Managed Agentsでは、1つのセッションにつきSessions APIの各リクエストにスパンが生成され、エージェントの各ターンにもターンスパンが生成される。各ターンスパンには、モデルへの各リクエスト、APIが実行する各ツール、各結果評価のスパンが含まれる。Claude Code、Agent SDK、Coworkの利用者には、これらの製品向けに個別のモニタリングおよび可観測性に関するドキュメントが案内されている。

コンテンツモード、制限、コンプライアンス上の動作

各送信先と各SDKクライアントにはコンテンツモードがあり、スパンにモデルへのプロンプトと応答を含めるかどうかを制御する。デフォルトの「メタデータのみ」では、識別子、タイミング、ステータス、トークン数に加え、エージェントやツールの名前と説明、MCPサーバーの名前など、ユーザーが選択したテキストが記録される。「全文」では、モデルへのプロンプトと応答も追加される。

「全文」モードでは、各スパンにデフォルトで最大0.75 MBのコンテンツが格納される。ドキュメントによると、これは英語テキストの20万トークンのコンテキストウィンドウに相当し、多くの可観測性プラットフォームやプロキシが設ける1 MBのリクエスト上限を下回る。100万トークンのコンテキストウィンドウ全体には約4 MBが必要となる。コンテンツが上限を超えると、SDKまたはAPIがその内容を短縮し、anthropic.content.truncated属性をtrueに設定する。リクエストのスパンでは、システムプロンプトと最も古いメッセージから順に省かれ、画像と文書は種類のみが示される。

Anthropicとの間でHIPAA、FERPA、またはK-12のデータ取り扱い制限が適用される組織では、設定されたコンテンツモードにかかわらず、送信先にエクスポートされるのはメタデータのみとなる。ただし、SDKのスパンにはこの制限は適用されない。ゼロデータ保持が適用されている場合も、「全文」モードを利用できる。APIは、エクスポートしたコンテンツを送信先に届けるまでメモリ内にのみ保持するためだ。Claude Managed Agentsはゼロデータ保持の対象外であり、OpenTelemetryの利用時も保持条件に変更はない。

トークン数を集計する際、ドキュメントでは、1つのリクエストにつき1つのソースのスパンだけを合計し、各トークンを一度だけ数えるよう案内している。SDKとAPIの両方のスパンがあるリクエストでは、APIのスパンを使用する。また、配信が再試行されると、スパンが複数回届くことがあるとも記している。

連携先として挙げられたサービスと初期顧客のコメント

発表では、対応する可観測性プラットフォームを用途別に紹介している。エージェントをソフトウェアスタック全体とあわせてデバッグする用途では、Grafana Cloud、Honeycomb、Sentry、Splunkを挙げている。エージェントのトレースをログやメトリクスと並べて確認できるため、処理の遅延や失敗の原因となったサービスを開発者が特定できる。実運用データを使ったエージェントの改善には、Arize AI、Braintrust、Datadog、Langfuse、LangChainのLangSmith、New Relic、PostHogを挙げ、実際のトレースを評価データに変換したり、品質上の問題を検出したりする用途を紹介している。組織全体の使用状況を追跡する用途ではDatabricks Unity Gatewayを挙げ、プラットフォームチームやセキュリティチームがチーム別のトークン使用量を確認し、異常な動きを検知できるとしている。

発表では、複数の初期顧客が導入事例を紹介した。Foxgloveの共同創業者兼CTOであるRoman Shtylmanは、同社がロボティクスチームによるロボットのデバッグを支援するエージェントを開発していると述べた。また、Claude PlatformからOpenTelemetry形式で直接エクスポートすることで、PostHog上でエージェントのやり取りを製品の使用状況データとあわせて分析できるようになり、実環境でのエージェントの性能を評価し、ロボティクスチーム向けの改善に優先順位を付けられると語った。

Rampのシニアソフトウェアエンジニア、David Traina氏によると、同社はLangfuseのトレースを採点し、繰り返し発生する障害を見つけて修正案を提示するエージェント型システム「Reflect」を構築した。「一部のエージェントでは、すでにトークン使用量を10～20％削減し、セッションを30％高速化できました」とTraina氏は述べ、Claude APIからOpenTelemetry形式でネイティブにエクスポートすれば、追加の手順なしで計測データをこの改善サイクルに直接取り込めると付け加えた。

Sterling Labsの最高技術責任者（CTO）、Hyon Lee氏によると、同社のエージェントはリアルタイムの市場を分析しており、ネイティブエクスポートにより、独自の計測機能を実装することなく、すべてのトレースをLangfuseにストリーミングできる。FloQastのインフラストラクチャ責任者、Ankush Sharma氏によると、同社の会計ソフトウェアのエージェントはClaude Platform上で動作し、テレメトリーデータはGrafana Cloudに送られる。これにより、各モデル呼び出しが、その呼び出しを含む照合または仕訳ワークフローと同じトレースに記録されるため、エージェントの動作について監査人から質問された際、同社は1つのタイムラインで回答できる。