エージェント監視用の OpenTelemetry

Copilot エージェントがどのように動作し、モデルやツールとやり取りするかを理解する。

この記事で

OpenTelemetry (OTel) は、オープンソース監視フレームワークです。 テレメトリ イベントとメトリックを収集し、互換性のある監視ツールにエクスポートする標準的な方法が提供されます。 詳細については、OTel Web サイトの 「OpenTelemetry とは」 を参照してください。

OTel 監視を有効にすると、ユーザーの Copilot クライアントから OTel 互換バックエンドにデータを送信できます。 これにより、エージェント セッションを分析し、企業全体のエージェントの使用状況を把握できます。

Copilotはどのようなデータを送信しますか?

Copilot は、次の 3 種類のデータを送信します。

  • トレース は、エージェント セッションのフローを示し、モデル呼び出しやツールの使用など、各ステップを接続します。 たとえば、トレースでは、 readFile ツールを使用してモデルを呼び出し、モデルをもう一度呼び出して応答を生成するエージェントを示すことができます。
  • メトリック は、時間の経過に伴うパターンの識別に役立つ数値測定値です。 たとえば、トークン使用状況メトリックは、モデル呼び出しで使用される入力トークンと出力トークンの数を追跡します。
  • イベントは 、特定の時点で個々のアクションを記録します。 たとえば、編集フィードバック イベントでは、ユーザーがエージェントの編集を承諾したか拒否したかが記録されます。

既定では、データにはプロンプト、応答、またはツール引数は含まれません。 このコンテンツをキャプチャすることもできますが、コード、ファイルの内容、ユーザー プロンプトなどの機密情報が含まれている場合があります。

OpenTelemetry の有効化

ユーザーの Copilot クライアントから OTel データを収集するには:

  1. 監視バックエンドを設定します。 OpenTelemetry Protocol (OTLP) をサポートするセキュリティで保護されたバックエンドを選択します。 一部のバックエンドでは、OTLP データを直接受信できます。 他のバックエンドの場合は、 OpenTelemetry コレクター をデプロイして、データを受信、処理、転送します。 例については、VS Codeドキュメントの「監視バックエンドでの使用」を参照してください。
  2. ユーザーのクライアントを構成します。 各クライアントで OTel を有効にするように構成値を設定し、エンドポイント、ヘッダー、および認証トークンを構成して、OTLP エンドポイントにデータを送信するように構成します。
  3. データを解釈します。 収集されたデータを使用してセッションを分析し、傾向を特定します。 実装例については、Microsoftドキュメントの「Grafana を使用して AI コーディング エージェントを監視する」を参照してください。

ユーザーのクライアントの構成

企業は、マネージド設定を使用して、サポートされているクライアント間で OTel 構成を適用できます。 これらの設定は、ユーザーのクライアント間で適用され、オーバーライドすることはできません。 telemetry プロパティには、OpenTelemetry を有効にして構成するためのキーが含まれています。

詳細については、「エンタープライズ管理設定の構成」および「エンタープライズ管理設定」を参照してください。

クライアント向けドキュメント

クライアント間での OpenTelemetry の使用方法の詳細については、次を参照してください。