テレメトリーソースを接続します

テレメトリソースを接続して、エージェントの回答を一般的な知識ではなく、あなた自身の信号に基づけましょう。 テレメトリーコネクタを設置したら、平易な言葉で調査質問をしてください。 エージェントはクエリを実行し、実数で回答します。

このチュートリアルでは 、テレメトリー カテゴリのコネクタについて扱っています。 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:コネクターを追加する

  1. sre.azure.com に移動し、エージェントを選択します。

  2. 左側のサイドバーで 「ビルダー」を展開し、「 コネクター」を選択します。

  3. [ コネクタの追加] を選択します。

  4. テ レメトリ タブを選択し、その後テレメトリソースを選択します。 Azure Data Explorerの場合は、Azure MCP Kustoパスを使用するAzure Data Explorerを選択してください。

ステップ2:認証

For Azure telemetry connectors:

  1. コネクターで示されたフィールドを補完します。

    • Azure Data Explorerでは、コネクターに名前を付け、エージェントがKustoに問い合わせる管理IDを選択し、クラスタURL付きのクラスタグループを1つ以上追加します。
    • Log Analytics Workspaceでは、ワークスペースピッカーからワークスペースを選択するか、手動でワークスペースのARMリソースIDを入力してください。
    • Application Insightsの場合は、リソースピッカーからApplication Insightsリソースを選択するか、手動でリソースARMリソースIDを入力してください。

  2. コネクターが 管理ID を求めたら選択してください。

  3. ウィザードで示されたレビュー、クラスタリング、ツール選択のステップを進めてください。

管理されたアイデンティティはターゲットリソースへの読み取りアクセス権を持っていなければなりません。 もしクエリが権限エラーで失敗した場合は、そのアイデンティティに読み取り権限を与え、再度クエリを試みます。

ステップ3:クエリツールの設定

セットアップツールのステップで、テレメトリを読み取る操作を有効にしてください。 クエリ操作はテレメトリコネクタの中核なので、run-queryまたはsearch操作を選択してください。 必要な場合以外は管理業務を無効にしておきましょう。

すべての読み取り操作を 「許可 」に設定し、エージェントが一時停止せずに質問に答えられるようにしてください。 データを変更する操作を有効にする場合は 、「Ask」に設定してください。

Azure Data ExplorerをAzure MCP経由で利用する場合、ウィザードにはクラスタグループステップと接続テストを含むレビューステップが含まれています。 クラスタグループを設定し、接続性をテストし、コネクタを保存してください。 KustoツールセットはAzure MCPのKustoパスで処理されます。

ヒント

有効セットは小さく保ちましょう。 テレメトリーコネクタは通常、クエリ操作のみで十分です。 工具が少ないことで、エージェントはより確実に適切なものを選び、80工具の予算内に収まります。

ステップ4:質問で検証する

  1. エージェントとチャットを始めましょう。

  2. テレメトリーが必要な質問をしてください。 例えば次が挙げられます。

    How many errors were logged in the last hour, grouped by service?

  3. 反応に注目してください。 ツールカードには、エージェントがコネクターのクエリツールを選択しクエリを実行する様子が示され、その後にあなたのテレメトリーに基づく回答が表示されます。

自分のソースから実際のカウントを見ると、一般的な説明ではなくコネクターが端から端まで動作します。

Troubleshooting

問題 Cause 修正
クエリは「無許可」または「禁止」を返します。 接続識別子には読み取りアクセスがありません 識別子にターゲットリソースへの読み取り権限を与え、再試行します。
クエリは「見つかりません」と返されます 間違ったワークスペース、クラスタ、データベース、またはテーブル名 サービス内で正確な名前を確認してください。 名前は大文字と小文字が区別されます。
サードパーティ製コネクタが接続できません URL、トークン、ヘッダーの値が間違っています 値の確認はあなたのオブザーバビリティ管理者と確認し、コネクターを更新してください。
答えは一般的なもので、ツールカードも表示されません その質問にはあなたのテレメトリーは必要ありませんでした 質問にテレメトリーが必要になるように言い換えてください。例えば「サービスXの失敗リクエストを最終日カウントしてください」といった感じです。
コネクタは保存されましたが、テレメトリは返っていません 空またはフィルターされた結果 質問の時間範囲を広げるか、ソースに最近のテレメトリがあるか確認してください。

関連するコンテンツ

  • Last updated on