テレメトリソースを接続して、エージェントの回答を一般的な知識ではなく、あなた自身の信号に基づけましょう。 テレメトリーコネクタを設置したら、平易な言葉で調査質問をしてください。 エージェントはクエリを実行し、実数で回答します。
このチュートリアルでは 、テレメトリー カテゴリのコネクタについて扱っています。 Azure Data ExplorerはAzure MCP Kustoパスを使用します。 サードパーティのテレメトリコネクタも、MCPを裏で使っていてもテ レメトリ タブに表示されます。 セットアップはすべてのマネージドコネクタと同じウィザードを使うため、この記事ではテレメトリーの詳細に焦点を当てます:ソースがどのように認証するか、どの操作を有効にするか、クエリで検証する方法です。
重要
マネージドコネクタはプレビュー段階です。 コネクターの入手可能性、フィールド、運用は変化する可能性があります。
前提条件
- 稼働中のSREエージェントと sre.azure.com へのアクセス。
- エージェントでコネクタを設定する権限を。
- 接続しているテレメトリソースへのアクセスを読み取ってください。 Azureソースの場合、接続を承認するアイデンティティは少なくともターゲットリソースへの読み取りアクセスが必要です。
コネクターをセットアップしたことがなければ、ウィザードの全攻略用にマネー ジドコネクタをセットアップ することから始めてください。 この記事ではテレメトリソースの違いのみを指摘しています。
テレメトリーコネクタ
| コネクタ | サービス | Authentication | 一般的な使用方法 |
|---|---|---|---|
| Azure Data Explorer (via Azure MCP) | Azure Data Explorer (Kusto) | マネージド ID | ADXクラスターに対してKQLクエリを実行します |
| Log Analytics ワークスペース | Log Analytics | マネージド ID | 読み取り専用モードでワークスペースログを照会 |
| Application Insights | Application Insights | マネージド ID | 読み取り専用モードでのアプリケーションテレメトリのクエリ |
| Datadog | Datadog | コネクターで示されるサービス認証情報 | クエリメトリクス、ログ、モニター |
| Elasticsearch | Elasticsearch | コネクターで示されるサービス認証情報 | 検索ログとインデックステレメトリ |
| Dynatrace | Dynatrace | コネクターで示されるサービス認証情報 | 観測可能性データとトレースのクエリ |
| New Relic | New Relic | コネクターで示されるサービス認証情報 | クエリテレメトリとインシデント |
| Splunk | Splunk | コネクターで示されるサービス認証情報 | 検索スプランクログとイベント |
| ホークアイ(ニューバード) | NeuBirdによるホークアイ | コネクターで示されるサービス認証情報 | AI搭載の観測データをクエリ |
サードパーティのテレメトリコネクタには、デフォルトのURL、認証、ヘッダーのヒントが含まれており、接続の設定に役立ちます。
また、ユーザーが提供したコネクタを通じて別のテレメトリソースを追加することもできます。 チームがカスタムツールやコネクタピッカーに記載されていないソースを持っている場合は、このオプションを使いましょう。
ステップ1:コネクターを追加する
sre.azure.com に移動し、エージェントを選択します。
左側のサイドバーで 「ビルダー」を展開し、「 コネクター」を選択します。
[ コネクタの追加] を選択します。
テ レメトリ タブを選択し、その後テレメトリソースを選択します。 Azure Data Explorerの場合は、Azure MCP Kustoパスを使用するAzure Data Explorerを選択してください。
ステップ2:認証
For Azure telemetry connectors:
コネクターで示されたフィールドを補完します。
- Azure Data Explorerでは、コネクターに名前を付け、エージェントがKustoに問い合わせる管理IDを選択し、クラスタURL付きのクラスタグループを1つ以上追加します。
- Log Analytics Workspaceでは、ワークスペースピッカーからワークスペースを選択するか、手動でワークスペースのARMリソースIDを入力してください。
- Application Insightsの場合は、リソースピッカーからApplication Insightsリソースを選択するか、手動でリソースARMリソースIDを入力してください。
コネクターが 管理ID を求めたら選択してください。
ウィザードで示されたレビュー、クラスタリング、ツール選択のステップを進めてください。
管理されたアイデンティティはターゲットリソースへの読み取りアクセス権を持っていなければなりません。 もしクエリが権限エラーで失敗した場合は、そのアイデンティティに読み取り権限を与え、再度クエリを試みます。
ステップ3:クエリツールの設定
セットアップツールのステップで、テレメトリを読み取る操作を有効にしてください。 クエリ操作はテレメトリコネクタの中核なので、run-queryまたはsearch操作を選択してください。 必要な場合以外は管理業務を無効にしておきましょう。
すべての読み取り操作を 「許可 」に設定し、エージェントが一時停止せずに質問に答えられるようにしてください。 データを変更する操作を有効にする場合は 、「Ask」に設定してください。
Azure Data ExplorerをAzure MCP経由で利用する場合、ウィザードにはクラスタグループステップと接続テストを含むレビューステップが含まれています。 クラスタグループを設定し、接続性をテストし、コネクタを保存してください。 KustoツールセットはAzure MCPのKustoパスで処理されます。
ヒント
有効セットは小さく保ちましょう。 テレメトリーコネクタは通常、クエリ操作のみで十分です。 工具が少ないことで、エージェントはより確実に適切なものを選び、80工具の予算内に収まります。
ステップ4:質問で検証する
エージェントとチャットを始めましょう。
テレメトリーが必要な質問をしてください。 例えば次が挙げられます。
How many errors were logged in the last hour, grouped by service?反応に注目してください。 ツールカードには、エージェントがコネクターのクエリツールを選択しクエリを実行する様子が示され、その後にあなたのテレメトリーに基づく回答が表示されます。
自分のソースから実際のカウントを見ると、一般的な説明ではなくコネクターが端から端まで動作します。
Troubleshooting
| 問題 | Cause | 修正 |
|---|---|---|
| クエリは「無許可」または「禁止」を返します。 | 接続識別子には読み取りアクセスがありません | 識別子にターゲットリソースへの読み取り権限を与え、再試行します。 |
| クエリは「見つかりません」と返されます | 間違ったワークスペース、クラスタ、データベース、またはテーブル名 | サービス内で正確な名前を確認してください。 名前は大文字と小文字が区別されます。 |
| サードパーティ製コネクタが接続できません | URL、トークン、ヘッダーの値が間違っています | 値の確認はあなたのオブザーバビリティ管理者と確認し、コネクターを更新してください。 |
| 答えは一般的なもので、ツールカードも表示されません | その質問にはあなたのテレメトリーは必要ありませんでした | 質問にテレメトリーが必要になるように言い換えてください。例えば「サービスXの失敗リクエストを最終日カウントしてください」といった感じです。 |
| コネクタは保存されましたが、テレメトリは返っていません | 空またはフィルターされた結果 | 質問の時間範囲を広げるか、ソースに最近のテレメトリがあるか確認してください。 |