# エージェント監視用の OpenTelemetry

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

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

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

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

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

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

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

## OpenTelemetry の有効化

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

1. **監視バックエンドを設定します。** OpenTelemetry Protocol (OTLP) をサポートするセキュリティで保護されたバックエンドを選択します。 一部のバックエンドでは、OTLP データを直接受信できます。 他のバックエンドの場合は、 [OpenTelemetry コレクター](https://opentelemetry.io/docs/collector/) をデプロイして、データを受信、処理、転送します。 例については、VS Codeドキュメントの[「監視バックエンドでの使用](https://code.visualstudio.com/docs/agents/guides/monitoring-agents#_use-with-observability-backends)」を参照してください。
2. **ユーザーのクライアントを構成します。** 各クライアントで OTel を有効にするように構成値を設定し、エンドポイント、ヘッダー、および認証トークンを構成して、OTLP エンドポイントにデータを送信するように構成します。
3. **データを解釈します。** 収集されたデータを使用してセッションを分析し、傾向を特定します。 実装例については、Microsoftドキュメントの[「Grafana を使用して AI コーディング エージェントを監視](https://learn.microsoft.com/en-gb/azure/managed-grafana/grafana-opentelemetry-app-insights)する」を参照してください。

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

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

詳細については、「[エンタープライズ管理設定の構成](/ja/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/configure-enterprise-managed-settings)」および「[エンタープライズ管理設定](/ja/copilot/reference/enterprise-administrators/enterprise-managed-settings)」を参照してください。

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

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

* VS Codeドキュメント[の OpenTelemetry](https://code.visualstudio.com/docs/agents/guides/monitoring-agents) を使用してエージェントの使用状況を監視する
* [Copilot SDK 用の OpenTelemetry インストルメンテーション](/ja/copilot/how-tos/copilot-sdk/observability/opentelemetry)
* [GITHUB COPILOT CLI コマンド リファレンス](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#opentelemetry-monitoring)