何が変わったか
AnthropicのPlatform文書は、Claude APIとSDKがMessages APIのリクエスト、ツール使用、Managed Agentsのセッションを、すでに動かしているオブザーバビリティプラットフォームへトレースできると述べています。トレースはリクエスト一つの全記録です。スパンはモデルリクエストやツール使用のような、その中の一段です。スパンはGenAIセマンティックコンベンションの属性を使うので、そのコンベンションに対応するプラットフォームは追加設定なしで認識できます。文書が挙げる用途は、失敗した、または遅いリクエストのデバッグ、トークン支出とレイテンシの追跡、実トラフィックからの評価づくりで、各リクエストはそれを送ったユーザーまたは機能と結び付きます。
発表記事は、同じトレースがClaude Managed Agents、Messages API、Claude SDKから得られ、Platform上のエージェントはすでにClaude CodeまたはCoworkのトレースを受け取っているツールに現れると述べています。Platform文書はClaude Code、Agent SDK、Coworkを、それぞれの監視ページへ案内します。記事は、Consoleに送信先を追加すると、エージェントのターン、モデル呼び出し、ツール使用のすべてが、レイテンシ、トークン、IDを伴う標準のOpenTelemetryトレースとして届くと述べています。文書は配信がベストエフォートであり、スパンが失われることがあると述べています。呼び出し側は、そのリクエストのサンプリング判断を運ぶtraceparentヘッダーでsampledフラグを切り、リクエストのスパンを外すこともできます。
誰向けで、アカウントの外に何が出るか
OTLP、つまりOpenTelemetryのエクスポートプロトコルを受け付けるプラットフォームは、どれも送信先になれます。文書はArize AI、Braintrust、Databricks、Datadog、Grafana Cloud、Honeycomb、Langfuse、LangSmith、New Relic、PostHog、Sentry、Splunkを名指しし、Langfuseをオープンソースと説明しています。発表記事は、Grafana Cloud、Honeycomb、Sentry、Splunkをログとメトリクスのそばでのデバッグに、Arize AI、Braintrust、Datadog、Langfuse、LangChainによるLangSmith、New Relic、PostHogを評価に、Databricks Unity Gatewayをチーム別のトークン使用量に分けています。文書はその最後のパートナーをDatabricksと記載しています。
Anthropicとの間でHIPAA、FERPA、またはK-12のデータ取り扱い制限がある組織では、コンテンツモードの設定にかかわらず、送信先はメタデータのみをエクスポートします。文書は、SDKスパンがその制限の影響を受けないと述べています。ゼロデータリテンションでも、Messages APIリクエストのFull contentは使えます。APIはエクスポートする内容を、配信するまでメモリにだけ保持します。Claude Managed Agentsはゼロデータリテンションの対象ではなく、文書はOpenTelemetryを使ってもその保持は変わらないと述べています。
| 選択 | 文書が述べていること |
|---|---|
| メタデータのみ（metadata_only） | 既定です。識別子、タイミング、ステータス、トークン数、そしてエージェントとツールの名前と説明、MCPサーバー名のように自分で選んだテキストが入ります。プロンプトと応答は出ません。 |
| フルコンテンツ（content） | モデルのプロンプトと応答が加わります。オブザーバビリティプラットフォームは、自前のアクセスと保持の設定の下にそれらを保存します。 |
| 既定のサイズ | スパンあたり0.75MBです。文書は、英語の200kトークンのコンテキストに収まり、プラットフォームやプロキシに多い1MBの上限を下回ると述べています。 |
| 1Mトークンのウィンドウ | 1Mトークンのコンテキストウィンドウ全体には約4MBが必要です。プラットフォームがより大きいペイロードを受け付けるとき、上限を上げるか外します。 |
| パートナーをProviderにする | Consoleの別の選択です。パートナーのプラットフォームをProviderに選ぶと、Consoleがそのプラットフォームの受け付ける上限を設定します。 |
| より小さい上限 | オブザーバビリティプラットフォーム、またはその前段のプロキシが大きなリクエストを拒否するとき、上限を下げます。 |
| 上限を超えたとき | 内容は短くなり、anthropic.content.truncatedがtrueになります。リクエストのスパンはシステムプロンプトと最も早いメッセージから落とします。ツールのスパンは末尾のブロックから落とします。画像と文書は種別だけが現れます。 |
| 変更する場所 | SDKはtraces.max_content_bytesです。ConsoleではFull contentを設定し、Advanced settingsのMaximum content size in MBを変えます。 |
有効にする手順と、トークンを一度だけ数える方法
SDKトレースとは、SDKをインストールし、tracer providerを登録することです。文書は、SDKがスパンを出せるようにする登録手順としてこれを挙げています。APIトレースとは、Claude Consoleに送信先を追加することです。発表記事は、Managed AgentsとMessages APIにはそのConsoleの送信先が必要で、Claude SDKはトレースを自動でエクスポートすると述べています。文書はSDKスパンに、なおtracer providerを要求します。両方を設定すると、一つのリクエストのSDKスパンとAPIスパンを一つのトレースで見られます。Claude Platform on AWSへのリクエストでは、APIスパンはそれぞれのトレースに残ると文書は述べています。
文書はSDKトレース、APIトレース、両方を比較しています。その列の順に、セットアップはコード、次にConsole、次に両方です。必要な権限はNone、次にAdmin、次にAdminです。対象範囲はSDKを使うクライアント、次に任意のクライアント、次に任意のクライアントです。
文書のMessagesの例では、アプリケーションがtool runnerを呼びます。tool runnerはツールを実行し、その結果を返すSDKの補助機能です。SDKはtool-runnerスパン、カスタムのクライアントツールスパン、各リクエストのクライアントcreateスパンを出します。APIはサーバーのcreateスパン、モデルリクエストごとのスパン、APIが実行するサーバーツールまたはMCPコネクタツールごとのツールスパンを出します。
Messages APIリクエストにSDKスパンとAPIスパンの両方があるときは、APIスパンを合計します。両方とも名前はanthropic.messages.createです。kindで区別します。SDKスパンはCLIENT、その子であるAPIスパンはSERVERです。APIのMessagesスパンの合計は、二つの組のどちらかです。anthropic.messages.createスパンか、anthropic.model_requestスパンです。Managed Agentsのセッションでは、anthropic.model_requestとanthropic.session.outcome_evaluationのスパンを合計します。一つのセッションのスパンは複数のトレースに分かれ得ます。multiagentがオンのとき、gen_ai.conversation.idが一つのスレッドを、anthropic.session.idがセッション全体をまとめます。gen_ai.usage.input_tokensには、プロンプトキャッシュの読み書きがすでに含まれます。再送で同じスパンが再び届いたら、trace IDとspan IDで一度だけ数えます。表は、出所ごとに一度だけ足す一覧です。
SDKのcreateスパンでは、anthropic.usage.compaction.input_tokensとanthropic.usage.compaction.output_tokensも加えます。gen_ai.usage.*にコンパクションのトークンが入らないためです。フォールバックのモデルがリクエストを処理したなら、そのSDKスパンにあるのは応答を実際に返したモデルの使用量だけです。APIのMessagesスパンでは、そのリクエストのanthropic.compactionスパンを加え、createスパンのanthropic.usage.compaction.*属性は同じ合計に入れません。同じトークンを保持しているためです。
| 出所 | 合計に入れるスパン | コンパクションとフォールバック |
|---|---|---|
| SDKスパンとAPIスパンの両方があるMessagesリクエスト | kindがSERVERのAPI anthropic.messages.createスパン。同じ名前のSDKスパンはkindがCLIENTです。 | 続いてAPI Messagesの行を使います。 |
| SDKのcreateスパン | anthropic.messages.create | anthropic.usage.compaction.input_tokensとanthropic.usage.compaction.output_tokensも加えます。フォールバックスパンには、応答を実際に返したモデルの使用量だけがあります。 |
| APIのMessagesスパン | anthropic.messages.createかanthropic.model_requestのどちらか | anthropic.compactionスパンも加えます。createスパンのanthropic.usage.compaction.*属性は同じトークンを持つので、この合計には入れません。 |
| Managed Agentsのセッション | anthropic.model_requestとanthropic.session.outcome_evaluation | 数え方の規則は、これらのスパンへの別個のコンパクション加算を挙げていません。一つのセッションのスパンは複数のトレースに分かれ得ます。 |
価格、日付、引用が測っているもの
OpenTelemetry文書と発表記事は、価格、プランの階層、エクスポート枠、一般提供の日付を示していません。記事本文にも、それ自身の公開日はありません。ベータの注意書きは、このエクスポートがAnthropicとの契約、その中のService Specific TermsにあるBeta Servicesの節に従って提供されると述べています。
RampのDavid Trainaは、Langfuseのトレースに点数を付けるReflectが、一部のエージェントですでにトークン使用量を10–20%減らし、セッションを30%速くしたと述べています。彼は、Claude APIからのネイティブなエクスポートがその改善の循環に入り得ること、そしてReflectは観察したものだけを改善できると述べています。これらの割合は、Reflectの既存の結果についての彼の説明です。記事はほかに、FoxgloveのRoman Shtylmanが製品利用のそばのPostHogについて、Sterling LabsのHyon Leeがカスタム計装なしでLangfuseがすべてのトレースを受け取ることについて、所属組織の記載がないインフラ責任者Ankush Sharmaが照合と仕訳のワークフローのそばのGrafana Cloudについて述べた箇所を引用しています。Leeの「すべてのトレース」という一節は、文書のベストエフォート配信と並びます。
Claude Codeの変更履歴は、これとは別にClaude CodeのトレーススパンへGenAI属性を加えています。gen_ai.provider.name、gen_ai.conversation.id、gen_ai.tool.name、error.typeが含まれ、api_requestイベントにはcache_creation_5m_tokensとcache_creation_1h_tokensが追加されます。それらの箇条書きはバージョンを記しておらず、このConsoleの送信先ではなくClaude Codeのテレメトリです。
出典
あわせて
資料と編集方針
このブリーフは、2026年10月15日のClaudeDevsの投稿、AnthropicのPlatform OpenTelemetry文書、発表記事「Trace agents with OpenTelemetry on the Claude Platform」を、いずれもその日に読んだ内容に拠っています。Claude Code変更履歴のGenAIスパン属性の箇所は、Platformのエクスポートと分けて置くためだけに含めています。それらの箇条書きにバージョンの見出しはありません。Beta Servicesの条項、スパン属性リファレンス、トークン使用量属性のページ、ならびにClaude Code、Agent SDK、Coworkの監視ページは、今回の閲読の範囲外です。送信先は設定しておらず、トレースもエクスポートしていません。