Anthropic、Claude APIのOpenTelemetry(オープンテレメトリ)出力をベータで開始Messages APIとManaged Agentsを自社の監視基盤で追跡、SDKは7言語
Anthropicは2026年10月14日、Claude APIのMessages APIとClaude Managed AgentsのセッションをOpenTelemetryで追跡できる機能をベータで始めたと公式リリースノートに記した。SDKはPython・TypeScript・C#・Go・Java・PHP・Rubyの7言語でスパンを出し、API側はClaude Consoleで送信先を追加する。

目次
Anthropic(アンスロピック)は2026年10月14日(現地)、Claude APIの公式リリースノートに、Messages APIのリクエストとClaude Managed Agents(クロード マネージド エージェンツ)のセッションをOpenTelemetry(オープンテレメトリ)で追跡できる出力機能をベータで始めたと記しました。Claude SDKはPython・TypeScript・C#・Go・Java・PHP・Rubyの7言語でスパンを出し、API側のスパンはClaude Consoleで送信先を追加すると受け取れる、とのことです。
3行まとめ
- Anthropicは2026年10月14日、Claude APIのOpenTelemetry出力をベータで開始したとリリースノートに記載。対象はMessages APIとClaude Managed Agentsのセッション
- SDK側は7言語(Python・TypeScript・C#・Go・Java・PHP・Ruby)、API側はClaude Consoleで送信先を追加(Admin権限)
- 既定は「メタデータのみ」。プロンプトと応答を含める「全内容」モードもあり、1スパンの内容は既定で最大0.75MB
本記事の内容は、日本時間10月15日2時台に公式ページで確認したものです。
何ができるようになったのか
公式ドキュメント「OpenTelemetry for the Claude API」によると、Claude APIとSDKは、Messages APIのリクエスト、ツールの使用、Managed Agentsのセッションを、OpenTelemetryで追跡できます。利用者がすでに使っている監視基盤で見られ、使い道として公式は次を挙げています。
- 失敗したリクエストや遅いリクエストのデバッグ
- トークン消費とレイテンシーの把握
- 実際のトラフィックからの評価データ(evals)づくり
- アプリケーション自身のトレースの中で、各リクエストをどのユーザーや機能が送ったかと結びつけて見ること
OpenTelemetryは、多くの監視基盤が対応するベンダー中立の標準です。ドキュメントの説明では、トレースは1つのリクエストの全記録、スパンはその中の1ステップ(モデルへのリクエストやツールの使用など)です。属性にはGenAIセマンティック規約のものを使うため、規約に対応する基盤なら追加設定なしでスパンを認識できる、とされています。
設定は2通り──SDKとAPI
ドキュメントは「SDKでのトレース」「APIでのトレース」の2つを用意し、両方を設定するとSDKとAPIのスパンが1つのトレースにまとまると説明しています。
| SDKでのトレース | APIでのトレース | |
|---|---|---|
| 設定の場所 | コード(SDKを入れ、トレーサープロバイダーを登録) | Claude Console(送信先を追加) |
| 必要な権限 | なし | Admin |
| 対象 | SDKを使うクライアント | あらゆるクライアント |
| クラウド | すべて | Claude Platform、Claude Platform on AWS |
(表は公式ドキュメントの比較表のうち、文字として取得できた行をまとめたものです。「何が見えるか」の行は、取得したテキストでは対応を示す印が読み取れませんでした。)
Claude Platform on AWSへのリクエストでは、API側のスパンは別のトレースになる、と書かれています。Claude Code、Agent SDK、Coworkについては、ドキュメントはそれぞれ別のモニタリング文書(Claude Code monitoring、Agent SDK observability、Cowork activity monitoring)を参照するよう案内しています。
送れる先は「OTLPを受け付ける基盤」なら
公式ドキュメントは、OTLPを受け付ける監視基盤ならどこにでも送れるとし、パートナーとして次の12社を挙げています。Arize AI、Braintrust、Databricks、Datadog、Grafana Cloud、Honeycomb、Langfuse、LangSmith、New Relic、PostHog、Sentry、Splunk。
プロンプトの中身は送られるのか
ここが導入前に確認したい点です。公式ドキュメントによると、送信先ごと、SDKクライアントごとに「コンテンツモード」があります。
| モード | SDKでの値 | スパンに含まれるもの |
|---|---|---|
| メタデータのみ(既定) | metadata_only |
識別子、時間、状態、トークン数、エージェントやツールの名前・説明、MCPサーバー名など利用者が選ぶテキスト |
| 全内容 | content |
上記に加え、モデルへのプロンプトと応答 |
全内容にすると、失敗や遅延の理由、会話全体、評価データづくりに使える一方、公式は「中身は監視基盤側のアクセス・保持の設定で保存されるので、組織の要件を満たすか確認を」と注意しています。
例外も書かれています。
- HIPAA、FERPA、K-12のデータ取り扱い制限をAnthropicとの間で結んでいる組織では、送信先はコンテンツモードにかかわらずメタデータのみを出力します。SDKのスパンは影響を受けません。
- ゼロデータリテンション(ZDR)でも全内容は使えます。Messages APIでは、送信先に届けるまでAPIが内容をメモリ上にだけ保持します。Claude Managed AgentsはZDRの対象外で、OpenTelemetryを使ってもデータ保持の扱いは変わらない、とのことです。
- 全内容では、1スパンが保持する内容は既定で最大0.75MBです。公式は、英語テキストの200kトークンの文脈が収まり、多くの監視基盤やプロキシの1MBというリクエスト上限を下回る大きさだと説明しています。超えた分は切り詰められ、
anthropic.content.truncatedが true になります。画像と文書は種類だけが残ります。1Mトークンの文脈を丸ごと残すには約4MBが必要とも書かれています。
トークンの数え方に注意
ドキュメントには「トークンを二重に数えない」ための節があります。同じMessages APIリクエストにSDKのスパンとAPIのスパンがある場合は、APIのスパンを合計します。両方とも名前が anthropic.messages.create なので、種別(SDKは CLIENT、APIは SERVER)で見分けます。配信の再試行でスパンが重複して届くことがあり、重複を除かない基盤では、トレースIDとスパンIDで1回ずつ数える、とされています。
前と何が違うのか
今回確認した2ページでは、これまでの料金や仕様と比べた記述は見当たりませんでした。リリースノートの該当項目は、機能の開始、SDKの対応言語、API側の設定場所の3点を1項目にまとめたものです。同じページの一つ前の項目は10月9日付で、日付の並びでは今回が最新です。
筆者が確認したこと
日本時間10月15日2時15分に、リリースノート本体とOpenTelemetryのドキュメントを取得して読みました。製品そのものは試していません。気づいたのは、リリースノートの項目が機能の開始・SDKの7言語・Consoleでの送信先追加の3点だけを書くのに対し、ドキュメント側はAPIのスパンだけで取れる範囲、SDKだけで取れる範囲、両方で取れる範囲を比較表で分け、さらに「スパンは最後まで届く保証がない」と明記していることです。次の節にその部分を整理します。
配信は「ベスト・エフォート」で、使用量の正本ではない
公式ドキュメントは、書き出されたスパンがAPI使用量の完全な記録である保証はないと書いています。配信はベスト・エフォート(最善努力)で、スパンが失われることがあります。また、呼び出し側がリクエストの traceparent ヘッダーで sampled フラグを切ると、そのリクエストのスパンは出ません。APIキーごとの使用量の把握(たとえば漏えいしたキーの発見)にはUsage APIを使うよう勧めており、こちらはスパンのないリクエストの使用量も数えるとのことです。
日本での提供・料金について
今回取得した2つの公式ページには、OpenTelemetry出力の追加料金や、日本での提供可否、リージョン別の違いに関する記載は見当たりませんでした(「pric」「free」「charge」「Japan」「region」などで両ページを検索して確認)。ベータである点は、ドキュメントに「Beta」の表示と、Anthropicとの契約(Service Specific Termsのベータサービスの節を含む)のもとで提供されるという文言があります。ページの本文は英語のみでした。なお、リリースノートには他の項目でリージョンや料金を扱うものがありますが、OpenTelemetryとは別の話です。
出典と確認時刻
- Claude Platform Docs リリースノート(October 14, 2026の項): https://platform.claude.com/docs/en/release-notes/overview#october-14-2026
- OpenTelemetry for the Claude API: https://platform.claude.com/docs/en/manage-claude/opentelemetry
確認時刻はいずれも日本時間2026年10月15日2時15分(リリースノート2:15:18、ドキュメント2:15:38)です。本記事は続報があり次第更新します。
この記事でよく聞かれること
- Claude APIのOpenTelemetry出力とは何ですか?
- Anthropicの公式ドキュメントによると、Messages APIのリクエスト、ツールの使用、Claude Managed AgentsのセッションをOpenTelemetryのスパンとして出力し、利用者がすでに使っている監視基盤で見られる機能です。2026年10月14日のリリースノートでベータ提供の開始が記されました。
- どの言語のSDKが対応していますか?
- リリースノートによると、Claude SDKがスパンを出すのはPython、TypeScript、C#、Go、Java、PHP、Rubyの7言語です。
- API側のスパンはどう受け取りますか?
- 公式ドキュメントでは、Claude Consoleで送信先(destination)を追加します。必要な権限はAdminです。OTLPを受け付ける監視基盤であれば送信でき、Datadog、Grafana Cloud、Sentry、Langfuseなど12社がパートナーとして挙げられています。
- プロンプトや応答の中身も送られますか?
- 既定は「メタデータのみ」で、識別子、時間、状態、トークン数などです。「全内容」を選んだ場合に限り、プロンプトと応答もスパンに含まれると公式ドキュメントは書いています。送信先の保存・保持の設定は利用者側で確認する必要があるとも書かれています。
出典・参照資料
大きいニュースはYouTubeでも解説しています。Xでは新着記事をお知らせしています。
コメント
まだコメントはありません。最初のコメントを書いてみませんか?
AIについて聞きたいことはありますか?
質問箱で無料で受け付けています。回答は公開され、他の方の参考にもなります。
質問箱を見る →