Claude Platform: API・Managed Agents の実行を OpenTelemetry トレースで手元の監視基盤に送る
Claude Platform(public beta)が、Messages API・Claude Managed Agents・Claude SDK の呼び出しを OpenTelemetry のトレースとして外部の監視基盤に送れるようになった。
どんな時に使う?
- 自作エージェントや Managed Agents の「どのツール呼び出しで遅い/高い/失敗した」を、既存の Grafana/Datadog/Honeycomb などで見たい
- CLI の利用状況(AIコーディング: Claude Code / Codex / Copilot CLI の利用状況を OpenTelemetry でエクスポートする)だけでなく、API 側の実行も同じ画面で追いたい
要点
- スパンは OpenTelemetry の gen_ai セマンティック規約に沿う。既定で載るのはメタデータ: 所要時間、ステータス、トークン数、モデル、ツール名
- 送信先を "full content" に切り替えると、プロンプト・応答・ツール入力・ツール結果も送られる
- 手順は Claude Console で送信先(OTLP エンドポイント)を設定 → 対象(Messages API / Managed Agents / SDK)を選ぶ、の流れ。詳細は公式ドキュメント
注意点
- full content は機密や個人情報もそのまま監視基盤に流れる。まずメタデータのみで始め、必要な送信先だけ full にする
- public beta なので項目名や料金扱いは変わりうる
- Claude Code 2.1.300 でも OpenTelemetry の GenAI トレース属性が追加されている