Application Insights を使用してテレメトリを取り込む

Copilot Studio エージェントを Application Insights に接続する

エージェント を Application Insights に接続するには、まず エージェント の構成にインストルメンテーション キーを追加する必要があります。

1. エージェントの設定ページに移動し、詳細を選択します。

2. Application Insights セクション内で、接続文字列 設定を入力します。 接続文字列の検索方法については、Azure Monitor ドキュメント を参照してください。

3. 必要に応じて、次のいずれかの設定を有効にすることができます。

   • ログ活動: 有効化すると、受信/送信のメッセージとイベントの詳細がログに記録されます。

   • 機密性の高いアクティビティ プロパティをログに記録する: 有効にすると、受信/送信のメッセージとイベントで機密性が高いと見なされる特定のプロパティの値がログに含まれます。 潜在的に機密性が高いと見なされるプロパティは、userid、name、text、speak です (text と speak プロパティはメッセージにのみ適用されます)。

Application Insights を使用してボット テレメトリを分析する

ボットを Application Insights に接続すると、Copilot Studio でのテストなど、ユーザーがボットを操作したときにテレメトリ データがログに記録されます。 ログに記録されたテレメトリ データを表示するには、Azure にある Application Insights リソースの ログ セクションに移動します。

ここでは Kusto クエリ を使用して、データのクエリと分析を行うことができます。 クエリの例 を参照してください。

クエリの例

クエリは、Copilot Studio から記録されたすべてのカスタム テレメトリ イベントを示す customEvents など、単一のテーブルを指定するのと同じくらい簡単にできます。 ただし、Kusto クエリ を使用して、以下のような結果をさらに絞り込むこともできます;

• 時間間隔を追加する
• カスタム ディメンション を使用して結果を拡張します。 カスタム ディメンションは、タイムスタンプやイベント名などの事前に作成されたフィールドとともにログに記録されるカスタム プロパティです
• 条件に基づいて返されるデータを制限する where 句
• より多くの組み込み Kusto 関数を使用して、情報の表示内容や表示方法を決定します

以下のクエリの例では、過去 14 日間にボットと通信した 1 日あたりの個別のユーザーの数を示す折れ線グラフが表示されます。

let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart

テスト会話からのテレメトリをクエリから除外する

ボットは、テスト中に Copilot Studio 内で発生した会話も含め、すべての会話のテレメトリを記録します。 テスト中に収集されたテレメトリを除外する場合は、すべてのイベントでキャプチャされる designMode カスタム ディメンションを使用してクエリを拡張し、クエリで where 句を使用できます。

以下の例は、テスト キャンバスを通じてキャプチャされたものを除く、すべてのカスタム イベントを示しています。

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

カスタム ディメンション

Copilot Studio から受信した特定の活動データの多くは、customDimensions フィールドに保存されます。 クエリで 使用されているカスタム ディメンション フィールドを確認 して、テスト会話からテレメトリを除外することができます。

Bot Framework Composer と Copilot Studio を使用してイベント データを Application Insights のテレメトリ サービスに送信できます。 テレメトリは、どの機能が最も使用されているかを示すことで、ボットに関する分析情報を提供し、望ましくない動作を検出し、可用性、パフォーマンス、使用状況に関するデータを提供します。

Application Insights の接続

Composer で Application Insights サービスに接続するには、インストルメンテーション キーをプロジェクトに追加する必要があります。

1. Composerで、 構成 ページに移動します。

   

2. 詳細設定ビュー (json) を有効にします。

3. applicationInsightsセクションで、instrumentationKey設定に、ご利用の Application Insights インストゥルメンテーション キーが追加されます。

   

Composer の Adaptive ダイアログに使用する Application Insights 設定と使用、およびクエリの作成方法については、以下のリソースを参照してください:

• Microsoft Azure のサブスクリプション。
• Application Insights に関する入門情報。
• Azure Monitor のログ クエリの基本概念です。
• Composer の Adaptive ダイアログ用、Kusto クエリの例です。