室谷代表取締役Claude OpenTelemetryは、Anthropicが2026年10月14日に発表したClaude Platformの機能で、Messages API、Claude Managed Agents、Claude SDKsからOpenTelemetryのトレースを出力し、既存の可観測性スタックに送れるようにするものです。パブリックベータで提供開始という位置づけなんですよね。
テキトー教師DotAI 認定講師単にログが増えるという話じゃないんですよ。エージェントの1ステップずつが標準規格のスパンとして可視化される、というのが本質で。
AnthropicはXでこのパブリックベータ開始を発信しています。
AnthropicはXでこのパブリックベータ開始を発信しています。
室谷代表取締役ここで押さえておきたいのは、OpenTelemetryがベンダー中立の標準規格だという点です。トレースはシステムを通る1リクエストの完全な記録、スパンはその中の1ステップ。
モデルリクエストやツール使用が1スパンになるイメージですね。
モデルリクエストやツール使用が1スパンになるイメージですね。
テキトー教師DotAI 認定講師そうなんです。しかもClaudeのスパンはOpenTelemetryのGenAIセマンティック規約に従うので、規約に対応したプラットフォームなら追加設定なしでスパンを認識できる。
ここが実務では大きいんですよ。
ここが実務では大きいんですよ。
Claude OpenTelemetryとは？何が発表されたのか
まとめ
Claude OpenTelemetry 発表の要点
- 発表主体はAnthropic。Claude PlatformからOpenTelemetryトレースを出力できる機能をパブリックベータで提供開始
- 対象はMessages API、Claude Managed Agents、Claude SDKsの3つ
- Claude CodeやCoworkのトレースを可観測性ツールに送ることは既に可能だったが、Claude Platform上で構築するエージェントには同様の仕組みがなかった
- 今回の発表により、Claude Platform上のエージェントも既存の可観測性ツールの同じ場所に表示可能になった
- エージェント本番運用時の『中で何が起きているか見えない』という課題への、標準規格ベースのトレース出力というAnthropic側の答え
- Claude Platform on AWSはAPIスパンが独自のトレースになる違いがあり、環境によって挙動が変わる点に注意
室谷代表取締役発表の主語はあくまでAnthropicです。AnthropicがClaude PlatformからOpenTelemetryトレースを出力できる機能をパブリックベータで提供開始した、というのが今回のニュース。
対象はMessages API、Claude Managed Agents、Claude SDKsの3つです。
対象はMessages API、Claude Managed Agents、Claude SDKsの3つです。
テキトー教師DotAI 認定講師背景ブリーフによると、Claude CodeやCoworkのトレースを可観測性ツールに送ることは既に可能だったんですよ。でもClaude Platform上で構築するエージェントには、こうした仕組みが提供されていなかった。
室谷代表取締役そこが今回埋まったわけですね。Claude Platform上で作るエージェントも、既に使っている可観測性ツールの同じ場所に表示できるようになった、と説明されています。
テキトー教師DotAI 認定講師講座で受講生さんを見ていても、エージェントを本番に出す段階で『中で何が起きているか見えない』という壁にぶつかる方が多いんですよ。その壁に対するAnthropic側の答えが、この標準規格ベースのトレース出力というわけです。
室谷代表取締役ちなみにClaude Platform on AWSについては、APIスパンが独自のトレースになる、という違いも公式ドキュメントに書かれています。ここは環境によって挙動が変わるので注意なんですよね。
Claude OpenTelemetryでできること——デバッグ・コスト追跡・eval構築
Claude OpenTelemetryでできること
失敗・遅いリクエストのデバッグ
失敗したリクエストや遅いリクエストをデバッグする
トークン消費とレイテンシの追跡
トークン消費とレイテンシを追跡する
実トラフィックからevalを構築
実際のトレースをevalに変え、品質問題を捕まえ、変更が効いたかを測る
アプリのトレース内でリクエストを可視化
自分のアプリのスパンの下にClaudeのスパンが入れ子になり、遅いステップがどのサービス由来かを切り分けられる
テキトー教師DotAI 認定講師公式ドキュメントが挙げているユースケースを整理すると、こうなります。
室谷代表取締役お願いします。
テキトー教師DotAI 認定講師まず失敗したリクエストや遅いリクエストのデバッグ。次にトークン消費とレイテンシの追跡。
そして実トラフィックからevalを構築すること。最後に、アプリケーション自身のトレース内でリクエストを可視化する、という4点です。
そして実トラフィックからevalを構築すること。最後に、アプリケーション自身のトレース内でリクエストを可視化する、という4点です。
室谷代表取締役4つ目が個人的には効くなと思っていて。ユーザーや機能単位でリクエストが紐づくので、『どの機能が重いのか』がアプリのトレースと同じタイムラインで見えるんですよね。
テキトー教師DotAI 認定講師まさにそこです。単にClaude側のメトリクスを見るだけじゃなくて、自分のアプリのスパンの下にClaudeのスパンが入れ子になる。
だから遅いステップがどのサービス由来なのかを切り分けられるんですよ。
だから遅いステップがどのサービス由来なのかを切り分けられるんですよ。
室谷代表取締役あと公式ブログでは、本番データでエージェントを改善する話も出ています。実際のトレースをevalに変えて、品質問題を捕まえ、変更が効いたかを測る。
Rampの事例ではLangfuseのトレースを活用して、一部のエージェントでトークン使用量を10〜20%削減、セッションを30%高速化したと紹介されています。
Rampの事例ではLangfuseのトレースを活用して、一部のエージェントでトークン使用量を10〜20%削減、セッションを30%高速化したと紹介されています。
テキトー教師DotAI 認定講師これはAnthropicのブログに掲載されたユーザー企業の声であって、誰でも同じ数字が出るという話ではないですからね。ただ『観測できたものしか改善できない』というRampのコメントは本質を突いています。
室谷代表取締役エージェントに権限を渡す前に、モデル呼び出し・ツール使用・MCPサーバー呼び出しをトレースして、信頼性を確認してから権限を広げる。この順番を支えるのが今回の機能というわけです。
Claude OpenTelemetryの使い方・設定手順（SDK／API／Console）
SDKトレースとAPIトレースの設定比較
SDKトレース
- SDKをインストールしてtracer providerを登録する
- 必要な権限はなし
- SDKを使うクライアントが対象
- 自分のスパンの中でSDKを呼べばAPIスパンとつながる
APIトレース
- Claude Consoleでdestinationを追加する
- Admin権限が必要
- 任意のクライアントが対象
- W3Cのtraceparentヘッダーで自分のスパンの下に入れ子にする
室谷代表取締役設定はSDKトレースとAPIトレースの2系統があって、両方セットアップすると1つのトレースの中でSDKとAPIのスパンを一緒に見られるようになります。
テキトー教師DotAI 認定講師公式ドキュメントの手順を整理するとこうです。
- SDKトレース: SDKをインストールしてtracer providerを登録する。必要な権限はなし。SDKを使うクライアントが対象
- APIトレース: Claude Consoleでdestinationを追加する。Admin権限が必要。任意のクライアントが対象
- 両方: 1つのトレースでSDKとAPIのスパンをまとめて確認できる
室谷代表取締役APIトレースのdestination追加は、Consoleの組織のOpenTelemetry設定ページから『Add destination』をクリックして、Provider、OTLP endpoint URL、Request headers、Content mode、Workspacesなどを設定する流れですね。
テキトー教師DotAI 認定講師OTLP endpoint URLはHTTPSのベースURLで、ホスト名を使う必要があります。IPアドレスは不可。
パスプレフィックスは付けられて、
パスプレフィックスは付けられて、
/v1/tracesはAPI側が付けるので自分で足さないこと、と明記されています。室谷代表取締役認証情報はヘッダーの値だけに入れて、保存後はConsoleに再表示されない。ここは運用ルールを決めておかないと、後で誰が何を設定したか分からなくなるやつです。
テキトー教師DotAI 認定講師追加したら『Test』を実行して、anthropic.testスパンが可観測性プラットフォームに届くかを確認する。届かない場合はDelivery errorsを見る、という流れまで公式に書かれています。
室谷代表取締役ConsoleだけでなくAdmin APIやCLIでもdestinationを追加できるので、環境をコードで管理したいチームはそちらを使う形ですね。
テキトー教師DotAI 認定講師あと忘れがちなのが、APIスパンを自分のトレースにつなぐ設定です。デフォルトだとAPIスパンは独自のトレースになるので、W3Cのtraceparentヘッダーを介して自分のスパンの下に入れ子にする。
SDK経由なら自分のスパンの中でSDKを呼べばつながります。
SDK経由なら自分のスパンの中でSDKを呼べばつながります。
室谷代表取締役Messages APIはMCPコネクター経由でMCPサーバーにもトレースを渡すので、MCPサーバー側が自分のスパンをAPIスパンの下に置ける、というのも公式に書かれています。エージェントの全体像を追うには効きますよね。
メタデータのみとフルコンテンツ——出力されるデータの範囲
室谷代表取締役ここは運用で一番揉めるところです。destinationごと、SDKクライアントごとにコンテンツモードを設定できるようになっています。
テキトー教師DotAI 認定講師2つのモードを整理するとこうです。
- Metadata only（SDKでは
metadata_only）: デフォルト。識別子、タイミング、ステータス、トークン数、そして自分で選んだテキスト（エージェントやツールの名前・説明、MCPサーバー名など）が含まれる - Full content（SDKでは
content）: 最も可視性が高い。モデルのプロンプトと応答、そしてMetadata onlyの内容すべてが含まれる
室谷代表取締役デフォルトのスパンにはduration、status、token counts、model、tool namesといったメタデータが乗る、とAnthropicはXで説明しています。フルコンテンツに切り替えるとプロンプト、応答、ツールの入力、ツールの結果まで出る、と。
テキトー教師DotAI 認定講師Full contentにすると、なぜ実行が失敗したのか、なぜ遅かったのかが読めるようになる。会話全体を読める。
実トレースからevalを構築できる。ここが魅力なんですよ。
実トレースからevalを構築できる。ここが魅力なんですよ。
室谷代表取締役ただし公式ドキュメントには重要な注意があって、可観測性プラットフォーム側がそのコンテンツを独自のアクセス・保持設定で保存するので、自組織の要件を満たすか確認が必要とされています。データの置き場所がAnthropicの外に出るわけですからね。
テキトー教師DotAI 認定講師さらに、組織がAnthropicとの間でHIPAA、FERPA、K-12のデータ取り扱い制限を結んでいる場合、destinationのコンテンツモードに関係なくメタデータのみが出力される。ただしSDKスパンは影響を受けない、と明記されています。
室谷代表取締役ゼロデータ保持（ZDR）でもFull contentは使える、という点も書かれています。Messages APIのリクエストでは、エクスポートされるコンテンツはdestinationに届けるまでメモリ上にだけ保持される。
ただしClaude Managed AgentsはZDRの対象外で、OpenTelemetryを使ってもデータ保持の扱いは変わらない、と。
ただしClaude Managed AgentsはZDRの対象外で、OpenTelemetryを使ってもデータ保持の扱いは変わらない、と。
テキトー教師DotAI 認定講師コンテンツ量の上限も見逃せないです。Full contentで各スパンはデフォルト0.75MBまで。
これは英語テキストの200kトークンコンテキストに収まり、多くの可観測性プラットフォームやプロキシの1MBリクエスト制限を下回る、という設計意図が説明されています。
これは英語テキストの200kトークンコンテキストに収まり、多くの可観測性プラットフォームやプロキシの1MBリクエスト制限を下回る、という設計意図が説明されています。
室谷代表取締役上限を超えるとSDKかAPIがコンテンツを短縮して、
画像やドキュメントはタイプだけが残る、という挙動です。
anthropic.content.truncatedをtrueにする。リクエストスパンはシステムプロンプトと古いメッセージから先に落とし、ツールスパンは結果の末尾からブロックを落とす。画像やドキュメントはタイプだけが残る、という挙動です。
テキトー教師DotAI 認定講師上限は変更できて、SDKでは
traces.max_content_bytes、Consoleではdestination追加時にFull contentを選んでからAdvanced settingsのMaximum content sizeでMB指定。1Mトークンのコンテキスト全体を保持したいなら約4MB必要、という目安も公式に示されています。室谷代表取締役逆にプラットフォームや前段のプロキシが大きいリクエストを拒否するなら下げる。ここは自組織の受け側の制約に合わせて調整するしかないですね。
対応する可観測性ツールとOTLP連携の広がり
室谷代表取締役対応パートナーがかなり広いんですよ。公式ページに列挙されているのはArize AI、Braintrust、Databricks、Datadog、Grafana Cloud、Honeycomb、Langfuse、LangSmith、New Relic、PostHog、Sentry、Splunkです。
テキトー教師DotAI 認定講師しかもOTLP準拠の任意のツールにも送信可能とされています。標準規格ベースなので、特定ベンダーに閉じないのが設計思想として明記されているんですよ。
室谷代表取締役公式ブログでは用途別の整理もされていて、Grafana Cloud、Honeycomb、Sentry、Splunkではエージェントのトレースがログやメトリクスの隣に並ぶので、遅い・失敗したステップがどのサービス由来か分かる。Arize AI、Braintrust、Datadog、Langfuse、LangSmith、New Relic、PostHogでは実トレースをevalに変えて品質問題を捕まえ、変更の効果を測れる。
テキトー教師DotAI 認定講師組織全体の利用状況を見る用途では、Databricks Unity Gatewayにトレースを送って、プラットフォームチームやセキュリティチームがチーム別のトークン使用量を見たり、異常な活動にフラグを立てたりできる、と説明されています。
室谷代表取締役ClaudeのトレースがGenAIセマンティック規約に従うので、Claudeと他プロバイダーのデータが同じツール・同じダッシュボードで機能する、と明記されているのもポイントです。マルチモデルで運用しているチームには効きますよね。
テキトー教師DotAI 認定講師ユーザー企業の声も複数掲載されていて、FoxgloveはPostHogでエージェントの相互作用をプロダクト利用データと並べて分析。Sterling LabsはLangfuseにカスタム計装なしでトレースが流れ込むとコメントしています。
室谷代表取締役会計系のエージェントを運用する企業のコメントもあって、モデル呼び出しが照合や仕訳のワークフローと同じトレースに入るので、監査人に『エージェントが何をなぜやったか』を1つのタイムラインで答えられる、と。これは監査対応の文脈でかなり大きいですよ。
テキトー教師DotAI 認定講師講座でも『エージェントの説明責任』はよく話題になるんですけど、プロンプトのバージョン、ツール呼び出し、レイテンシ、トークン消費が同じタイムラインに並ぶというのは、説明の材料として強いですよね。
エージェント運用にどう効くか——権限拡大と本番データ活用の狙い
室谷代表取締役Anthropicのブログは『エージェントに大きな権限を渡すなら、その前にトレースを見る』という順序を明確に打ち出しています。モデル呼び出し、ツール使用、MCPサーバー呼び出しをトレースして、信頼できると確認できたら権限を広げる、と。
テキトー教師DotAI 認定講師これは単に便利機能が増えたという話じゃないんですよ。エージェントに権限を渡すための前提条件を、可観測性で担保しようという設計思想なんです。
室谷代表取締役MYUUUでもエージェントを組むときに、いきなり強い権限を渡すのは怖いので、まず狭い権限で走らせて挙動を見る、という進め方をします。その『挙動を見る』部分が標準規格のトレースで揃うのは実務的にありがたいんですよね。
テキトー教師DotAI 認定講師あとトークン数の数え方も公式に丁寧な指針があります。SDKスパンとAPIスパンの両方があるリクエストではAPIスパンを合計する。
両方とも
両方とも
anthropic.messages.createという名前なので、SDK側がCLIENT、その子のAPI側がSERVERというkindで見分ける、と。室谷代表取締役同じスパンが再送で複数回届くことがあるので、trace IDとspan IDで重複を除いて1回だけ数える。
このあたりは集計を間違えやすいポイントです。
gen_ai.usage.input_tokensにはプロンプトキャッシュの読み書き分が既に含まれているので、キャッシュ属性を足さない。このあたりは集計を間違えやすいポイントです。
テキトー教師DotAI 認定講師そして重要な注意として、エクスポートされたスパンはAPI利用の完全な記録であることは保証されない、と書かれています。配信はベストエフォートで、スパンが失われることがある。
呼び出し側がtraceparentヘッダーのsampledフラグをオフにすればスパンを出さないこともできる。
呼び出し側がtraceparentヘッダーのsampledフラグをオフにすればスパンを出さないこともできる。
室谷代表取締役APIキーごとの利用量を追いたい、例えば漏洩したキーを見つけたい、という用途ではUsage APIを使うこと、と明記されています。Usage APIはスパンのないリクエストの利用も数えるので、監査用途ではそちらが正、という整理ですね。
テキトー教師DotAI 認定講師配信の仕様も細かく決まっていて、at least onceで重複があり得る、ベストエフォートでスパンは失われ得る、最初のリクエストはgzip圧縮され
Content-Encoding: gzipが付く、400や415が返れば圧縮なしで即再送、タイムアウトや接続・TLS・DNS障害、408・429・5xxでは限られた回数だけ後で再試行する、と。室谷代表取締役エンドポイント側はTLSハンドシェイク5秒以内、レスポンスヘッダー5秒以内、配信全体で10秒。User-Agentは
受け側を自前で作るチームはこの制約に合わせて設計する必要があります。
Claude-Platform。受け側を自前で作るチームはこの制約に合わせて設計する必要があります。
テキトー教師DotAI 認定講師本機能はベータ提供で、Anthropicとの契約、Service Specific TermsのBeta Services条項に基づく、という点も忘れずに押さえておきたいですね。
室谷代表取締役Claude CodeのPython開発やAgent SDKの使い方はClaude CodeでPythonを完全攻略【2026年最新】でも解説しているので、SDKトレースを組むときの参考にしてください。エージェント設計の文脈だとAnthropic、Slack上でClaudeをチームメンバー化する「Claude Tag」ベータ公開も合わせて読むと、権限と可観測性のバランスが見えてきます。
テキトー教師DotAI 認定講師モデル側の動きだとAnthropic、最強エージェントモデル「Claude Sonnet 5」発表も押さえておきたいところです。エージェントを本番運用する流れが、モデルと可観測性の両輪で進んでいるのが分かりますよ。
よくある質問
室谷代表取締役ここからは、よく聞かれる点を公式ドキュメントに沿って整理していきます。
テキトー教師DotAI 認定講師まず『何をトレースできるのか』。Messages APIのリクエスト、ツール使用、Managed Agentsのセッションです。
SDKトレースとAPIトレースで取得できる範囲が違うので、両方セットアップすると1つのトレースでまとめて見られます。
SDKトレースとAPIトレースで取得できる範囲が違うので、両方セットアップすると1つのトレースでまとめて見られます。
室谷代表取締役『Claude Codeの監視にも使えるのか』という点ですが、公式ドキュメントではClaude Code、Agent SDK、Coworkについては別の監視ページを参照するよう案内されています。今回の発表はClaude Platform上のMessages API、Managed Agents、SDKが対象です。
テキトー教師DotAI 認定講師『どの可観測性ツールに送れるのか』は、OTLPを受け付ける任意のツール。公式に列挙されているパートナーはArize AI、Braintrust、Databricks、Datadog、Grafana Cloud、Honeycomb、Langfuse、LangSmith、New Relic、PostHog、Sentry、Splunkです。
室谷代表取締役『プロンプトや応答も送られるのか』は、コンテンツモード次第です。デフォルトはMetadata onlyで、Full contentに切り替えるとプロンプト、応答、ツール入出力まで含まれます。
ただし保存は可観測性プラットフォーム側のアクセス・保持設定に従うので、自組織の要件確認が必要です。
ただし保存は可観測性プラットフォーム側のアクセス・保持設定に従うので、自組織の要件確認が必要です。
テキトー教師DotAI 認定講師『スパンは完全な利用記録なのか』という点は、いいえ。配信はベストエフォートで、スパンが失われることがあります。
APIキーごとの利用量を正確に追いたい場合はUsage APIを使ってください、と公式に書かれています。
APIキーごとの利用量を正確に追いたい場合はUsage APIを使ってください、と公式に書かれています。
室谷代表取締役『料金はかかるのか』については、今回の発表ソースでは言及されていません。現時点では明らかにされていません。
テキトー教師DotAI 認定講師『日本から使えるのか』という点も、今回の資料では地域ごとの提供範囲についての記載がないので、現時点では明らかにされていません。Claude Consoleの組織設定からdestinationを追加できる環境かどうかを確認するのが確実です。
室谷代表取締役総じて、エージェントを本番で走らせるチームにとっては『見えないものを標準規格で見えるようにする』一歩なんですよね。ベータなので仕様は動く前提で、まずはMetadata onlyで様子を見て、必要ならFull contentに切り替える。
この順番が現実的かなと思います。
この順番が現実的かなと思います。
テキトー教師DotAI 認定講師そうですね。可観測性は後付けにすると痛い目を見るので、エージェントの権限を広げるタイミングとセットで設計に入れておきたいところです。
