Foundry トレースは、AI エージェントから顧客データをキャプチャする、Microsoft Foundry の監視機能です。 これは、開発者とオペレーターがシステムの動作を理解し、問題をデバッグし、パフォーマンスを最適化するのに役立ちます。
トレースでは、次のような情報が記録されます。
- ユーザー入力とプロンプト
- エージェントとモデルの入力と出力
- ツール呼び出しと中間ステップ
- 実行メタデータ (タイムスタンプ、待機時間、トークンの使用、エラーなど)
このデータには、ユーザーが生成したコンテンツと運用テレメトリが含まれる場合があります。
このデータは、エージェントの実行方法を可視化するために使用され、エージェント ワークフロー全体のトラブルシューティングとパフォーマンスの向上を実現します。 Foundry は OpenTelemetry 標準を使用し、トレース データを接続されたテレメトリ システムである Azure Monitor Application Insights に格納します。
Important
プロジェクトに対して AppInsights を有効にすると、AppInsights はトレースをログに記録して、エージェントとのユーザー レベルの対話を監視および評価するのに役立ちます。 AppInsights のLog Analytics閲覧者ロールを持つProjectメンバーは、個人データや顧客コンテンツを含む可能性のあるトレース データを表示できます。 基になるLog Analytics テーブルが保護されている場合 (保護レベルが Protected に設定されている場合)、メンバーには、そのトレース データを表示するための特権監視データ閲覧者ロールが必要です。 収集されるトレース データと、このデータを表示して使用できるユーザーを確認します。 詳細については、次のセクションを参照してください。
既定の状態:
- トレースは既定ではオフになっています。
- Foundry アカウント所有者または Foundry 所有者によって明示的に有効にされていない限り、トレース データは収集または格納されません。
追加Azure Monitor App Insights の価格が適用される場合があります。
これにより、お客様はデータ収集を開始するタイミングを制御できます。
トレースを有効にする
トレースは、プロジェクトが Azure Monitor Application Insights リソースに接続されている場合に有効になります。 一般的な有効化フローは次のとおりです。
- プロジェクトの作成時に Application Insights リソースを作成または接続する。
- Application Insights リソースが接続されていない既存のプロジェクトへの Application Insights リソースの作成または接続。
トレースを有効にする場合:
- トレース データは、プロジェクト内のすべてのエージェントの収集と格納を開始します。
- Foundry トレース UI でトレースを表示するには、Foundry プロジェクトにアクセスし、接続された Application Insights または Log Analytics ワークスペースに対する読み取りアクセス許可が必要です。 たとえば、Application Insights リソース、Log Analytics ワークスペース、または適切な親スコープでの Log Analytics 閲覧者、監視閲覧者、または閲覧者などのロールによって、このアクセスを許可できます。 基になるLog Analytics テーブルが保護されている場合、担当者は、そのデータを読み取るために特権監視データ閲覧者ロールも必要です。
トレースを無効にする
トレースを無効にするには、次の手順を実行します。
- Application Insights リソースの切断または削除。
トレースを無効にした後:
- そのプロジェクトのエージェントで新しいトレース データは収集されません。
- 以前に収集されたデータは、Application Insights のアイテム保持ポリシーの対象のままです。
Note
トレースを無効にする方法の正確な手順は、UI または SDK サーフェスによって異なります。製品ドキュメントと一致している必要があります。
データが格納される場所
- Foundry プロジェクトに接続されている Application Insights リソースには、トレース データが格納されます。
- Application Insights と Log Analytics の構成によって、データの保持とストレージが制御されます。 詳細については、「Log Analytics ワークスペースでのデータ保持の管理」を参照してください。
データ共有に関する考慮事項
- 接続されたテレメトリ リソースに対する適切なアクセス許可を持つユーザーがトレース データにアクセスできる場合があります。
- 構成によっては、同じプロジェクトまたはテナント内のユーザーにデータが表示される場合があります。
- Foundry トレース UI でトレースを表示するには、Foundry プロジェクトにアクセスし、接続された Application Insights または Log Analytics ワークスペースに対する読み取りアクセス許可が必要です。 たとえば、Application Insights リソース、Log Analytics ワークスペース、または適切な親スコープで Log Analytics Reader、Monitoring Reader、または Reader などのロールが割り当てられている場合、このアクセスが許可されます。 基になるLog Analytics テーブルが保護されている場合、担当者は、そのデータを読み取るために特権監視データ閲覧者ロールも必要です。
- ホストされるエージェントに固有のその他の考慮事項と重要な情報については、 ホストされるエージェント と ホストされるエージェントのプラットフォームによって挿入された環境変数を確認してください。
お客様は、アクセス制御を構成し、組織のポリシーに確実に準拠する責任を負います。
プライバシー
トレースでは、次のような個人データをキャプチャできます。
- ユーザープロンプトと応答
- アプリケーション固有のコンテンツ
ベスト プラクティス
- シークレット、資格情報、またはトークンのログ記録は避けてください。
- 記録する前に個人データを編集または最小化します。
- トレース データにアクセス制御と保持ポリシーを適用します。
データ保護コントロール
- 個人データの編集: メール アドレスや電話番号などの個人データを編集します。
- RBAC Log Analytics閲覧者ロールが付与されているユーザーを慎重に管理して、トレース データへのアクセスを制限します。 基になるLog Analytics テーブルが保護されている場合は、保護されたテーブルへの読み取りアクセスが許可されるため、特権監視データ閲覧者ロールを持つユーザーも管理します。
- 構成可能なポリシー: キャプチャして表示するデータを制御します。
これらの制御は、リスクを管理し、プライバシー要件に準拠するのに役立ちます。
お客様の責任
トレースを有効にする場合は、次の操作を行う必要があります。
- 収集されるデータの種類、目的、可視性を持つユーザー、そのオプション、および適切な選択を行うために必要なその他の情報 (該当する場合) など、エンド ユーザーにデータ収集について通知します。
- プライバシー、法律、規制の要件への準拠を確保する。
- 適切なアクセス制御とデータ保持ポリシーの構成。
まとめ
Foundry Tracing は、AI エージェントのデバッグ、監視、最適化を可能にする強力な監視機能です。 そうです：
- 既定ではオフです。
- テレメトリ リソースを接続して明示的に有効にします。
- 顧客がデータの収集と処理を制御できるように設計されています。