Claude、APIとエージェントの動きをOpenTelemetryで出力。会話まで送るかは「知りたいこと」で決める

Anthropicは2026年10月14日付のリリースノートで、Claude APIの処理をOpenTelemetryで出力する機能をベータ公開しました。Messages APIへのリクエストや、エージェント実行基盤であるClaude Managed Agentsのセッションを、既存の監視基盤で追えます。OpenTelemetryは、システムの処理記録を共通の形式で送るための標準です。

送る内容は、送信先ごとに「メタデータのみ」か「全文」を選びます。既定はメタデータのみで、プロンプトと回答は含みません。会話まで送るかは、トレースで何を知りたいかで決めると迷いません。

失敗・遅延・費用を追うなら、既定のメタデータで足りる

公式ドキュメントによると、メタデータのみでも、識別子、処理時間、成否、トークン数が記録されます。エージェントやツールの名前も含まれます。どのセッションのどのツール呼び出しで失敗したか、どこで時間やトークンを使ったかは、この範囲で追えます。

全文にすると、プロンプトと回答が加わります。公式は、失敗や遅延の理由、会話全体の確認、実際の利用からの評価データ作成に使えるとしています。

全文を送ると、会話を読める人が変わる

注意したいのは保存先です。全文で送った内容は、監視基盤側のアクセス権限と保存期間で管理されます。公式も、その設定が自社の要件を満たすか確認するよう求めています。

たとえば、社内問い合わせ対応のエージェントを試験運用している場面です。社員の質問文には、人事や顧客の情報が含まれ得ます。監視基盤を開発者全員が見られる設定なら、全文を送った時点で、問い合わせ内容を読める人が広がります。

全社はメタデータ、中身を見るのは検証用だけにする

送信先は、対象のワークスペースを「すべて」「選択したもの」「指定以外すべて」から選べます。そこで編集部の提案は、送信先を2つに分ける設計です。

• 全ワークスペース：メタデータのみ。失敗・遅延・費用を見る
• 検証用ワークスペース：全文。閲覧者と保存期間を決めた場所へ送り、回答の理由と評価データを見る

なお、トレースの配信はベストエフォートで、欠ける場合があると公式は説明しています。APIキーごとの利用量は、別のUsage APIで把握するよう案内しています。トレースを監査記録の代わりにしない前提で設計します。

トレースの設定で決めているのは、記録の細かさだけではありません。会話を読める人の範囲です。