メインコンテンツへスキップ
Dev Tools 14分で読める

ClaudeエージェントがOTel対応|OpenTelemetryで「ブラックボックス」を解体する

「エージェントが途中でコケても、どこで止まったか全然わからない。ログにはトークン数しか残らない」。daily.devのコミュニティでClaude Managed Agentsを使う開発者が繰り返してきた不満だ(daily.dev, 2026年10月)。複数の工程を連鎖させるエージェントは、どのモデル呼び出しで時間がかかったのか、どのツール呼び出しがコストを膨らませたのか、従来のログでは追いきれなかった。

その状況が2026年10月14日に変わった。AnthropicがClaude PlatformのOpenTelemetry(OTel)トレース対応をパブリックベータとして公開した。Managed Agents・Messages API・Claude SDKの3面が対象で、既存の可観測性スタック(Datadog、Grafana Cloud、Langfuseなど)にそのままトレースを流せる。

この記事はこんな人におすすめ
  • Claude Managed AgentsやMessages APIを本番運用している、またはこれから導入する開発者・SRE
  • エージェントのコスト・レイテンシを可視化して請求の根拠を作りたいPM・テックリード
  • DatadogやGrafanaなどの既存監視基盤にClaudeを組み込みたいインフラエンジニア

ブラックボックスだったエージェントの何が問題だったか

Claude Managed Agentsに限らず、AIエージェントの運用で最初に突き当たる壁は「何が起きたか分からない」という問題だ。

従来の監視では、1回のAPIレスポンスに対してレイテンシとトークン数が記録される。しかしエージェントが複数のモデル呼び出し・ツール呼び出し・サブエージェントの起動を連鎖させると、個々の数値を見ても「タスク全体でどこに時間がかかったか」が分からない。ある開発者は「予期しないAPI呼び出しが発生していると気づかず、月次請求でようやく発見した」と報告している(devops.com, 2026年10月)。

OTel対応前の回避策は主に2つだった。一つは、OpenInference Anthropic Instrumentor(サードパーティの計装ライブラリ)などを手動で組み込む方法。もう一つは、Provectusのようなチームが構築した独自テレメトリパイプラインを使う方法だ(Provectus, 2026年)。どちらも自社でコードを維持する必要があり、モデルやSDKのバージョンアップに追随するコストが高かった。

セットアップ手順:Console経路とSDK経路

今回のベータが対象とするのはMCPサーバーを含むチェーン全体だ。公式ブログは「アプリケーションコード→モデル呼び出し→プラットフォームツール→下流MCPサーバー」をまたぐトレースが取れると説明している(claude.com/blog)。

セットアップは対象によって経路が分かれる。

Console経路(Managed Agents・Messages API) Claude ConsoleのAdmin権限でOTLP(OpenTelemetry Line Protocol)エンドポイントを登録するだけ。コード変更は不要で、エージェントの「ターン」「モデル呼び出し」「ツール使用」それぞれがスパン(処理の一区間を表すトレースの最小単位)として記録される。

SDK経路 Claudeのクライアントライブラリ内でOTLPトレーサープロバイダーを登録する。コンソール設定は不要な代わり、コード側での初期化が必要だ。プロンプト・レスポンスの内容を含めたい場合は、SDKが提供するオプトイン設定を有効にする(正確な変数名は公式ドキュメントを参照。ベータ期間中は変更される可能性がある)。設定しない場合、記録されるのはメタデータとトークン数のみで、内容は含まれない。

Claude Code CLAUDE_CODE_ENABLE_TELEMETRY=1と対応するOTLPエンドポイント環境変数を設定する。

スパンはOpenTelemetry GenAI Semantic Conventionsに準拠しており、Datadog・Grafana Cloud・Honeycomb・Langfuse・LangSmith・New Relic・Sentry・Splunk・Arize AI・Braintrust・PostHog・Databricks Unity Gatewayのいずれでも受け取れる。OTLP対応であれば独自ツールも動作する。

競合との比較:Claudeが「最初」のプロバイダーである意味

OpenAIのAgents SDKはDatadog・LangSmith・Langfuseなど第三者ライブラリによるOTel計装を可能にしているが、プラットフォームから直接OTLPエクスポートを提供しているわけではない。GoogleのGeminiも同様で、Future AGIのtraceAIライブラリを経由した計装は可能だが、Googleがコンソールから直接OTLP送信先を設定できる機能は現時点では公表されていない(bump.arahi.ai, 2026年)。

「コード変更なしでコンソールから直接OTLP宛先を登録できる」機能を主要プロバイダーの中で公表したのは、現時点ではAnthropicが最初だ。ただし、これは単一プロバイダーへの最適化だ。OpenAIとClaudeを混在させるシステムでは、ダッシュボードを別々に持つか、別途のオーケストレーション層でトレースを束ねる必要がある。

「可観測性」と「証拠」は別物という批判

この機能を評価する声だけではない。AIオブザーバビリティツールを提供するChainloopは「OpenTelemetryが見せるのは『何が起きたか』であって、『推論が正しかったか』ではない」と指摘している(devops.com経由)。ステップの実行順序やトークン数は記録されるが、エージェントが誤った判断をしたかどうかは別の評価基盤(eval: モデル出力の品質評価テスト)が必要だ。

daily.devのコミュニティでは、コメント傾向として約55%が肯定的、35%が「有用だが不十分」という印象だった(フォーマルな調査ではなくコメント全体の読み取り)。プロンプト内容を既定で記録しないプライバシー設計を評価する声が多い一方、「複数プロバイダーをまたいだトレースのつなぎ方」に疑問を投げかけるコメントもあった(daily.dev, 2026年10月)。

ベータ期間中に注意すべき制限

現時点のベータには明確な制限が2つある。一つ目は、GenAI Semantic Conventionsがまだ「開発中」の仕様であること。スパン属性名が変わる可能性があり、ダッシュボードのクエリを後から書き直す作業が生じるかもしれない。二つ目は、Claude Managed Agentsがゼロデータリテンション(ZDR)に対応していないこと。顧客データのZDR対応を義務づけている組織は、Managed AgentsのOTelトレース機能を現時点では利用できない。

実際に使い始めるなら

Console経路を使う場合の手順は単純だ。Claude ConsoleにAdmin権限でログインし、「Observability」設定からOTLPエンドポイントURLと認証情報を登録する。すでにDatadogやGrafanaを使っているチームは、既存のOTLPエンドポイントをそのまま使える。

1点だけ実運用で気をつけるべき点がある。Console側のAPI経由とSDK側の両方を同時に有効にすると、Arize AIが指摘するように「1リクエストが2回スパンに記録される」重複が起きる。片方に統一するのが無難だ。

コストを管理したいチームには、Braintrust(月100万スパンまで無料)やLangfuseのセルフホスト版が導入コストを抑えやすい。Datadogを使いたい場合はスパン数に応じた料金体系をあらかじめ確認しておくことを勧める。

OpenTelemetryベータの現在地
  • 対象: Managed Agents・Messages API・Claude SDKs(Claude Code含む)
  • 対応バックエンド: Datadog、Grafana Cloud、Honeycomb、Langfuse、LangSmith、New Relic、Sentry、Splunk、Arize AI、Braintrust、PostHog、Databricks Unity Gatewayほか
  • プロンプト内容: 既定は非記録(opt-inで有効化)
  • ZDR: Managed Agentsは現在非対応
  • 仕様の安定性: GenAI Semantic Conventionsは開発中(属性名変更の可能性あり)

エージェントの運用コストを見える化するのは、開発チームとビジネス側が同じ地図を見て話すための第一歩だ。OTelトレースはそのための道具であって、エージェントが「正しく考えているか」を保証するものではない。可観測性の導入と並行して、eval(モデル出力の品質評価テスト)による品質評価の設計を進めることが現実的なロードマップになる。

Claude Managed Agentsの費用構造や上限値について詳しく知りたい場合は、「Claude Managed AgentsのDynamic Workflows」を参照してほしい。

詳しく見る

関連記事


本記事の情報は2026年10月18日時点のものです。OpenTelemetryのパブリックベータ期間中は仕様が変更される場合があります。最新情報はAnthropicの公式ブログおよびドキュメントを参照してください。

Share