Azure SRE エージェントのコネクタ

エージェントには、Azure サービスへの組み込みアクセスが用意されています。 Azure Monitor、Application Insights、Log Analytics、Azure Resource Graphのクエリを実行できます。 コネクタは、外部システム (Kusto クラスター、ソース コード リポジトリ、コラボレーション ツール、カスタム API) にまで拡張されます。

注

コネクタを 使用すると、エージェントは、ログのクエリ、通知の送信、コードの読み取りなどのデータとアクションにアクセスできます。 インシデント プラットフォーム は別の概念です。アラートの発生場所と、エージェントが自動的に応答する方法を制御します。 この記事では、コネクタについて説明します。 インシデント プラットフォームの詳細については、「 インシデント プラットフォーム」を参照してください。

コネクタなしでエージェントができること

コネクタが設定されていない場合でも、エージェントには、マネージド ID と Azure ロールベースのアクセス制御 (Azure RBAC) のアクセス許可を通じて、組み込み機能があります。

組み込み機能 提供される内容
Application Insights アプリケーションテレメトリ、トレース、例外に対してクエリを実行します。
Log Analytics Log Analytics ワークスペースをクエリします。
Azure Monitor のメトリック メトリックの一覧表示とクエリを実行し、傾向と異常を分析します。
Resource Graph サブスクリプション間でAzure リソースを検出してクエリを実行します。
Azure Resource Manager/Azure CLI 任意のAzureリソースの種類を読み取り、変更します。
Azure Kubernetes Service (AKS)診断 kubectl コマンドを実行し、Kubernetes の問題を診断します。

Resource Graph およびResource Manager操作は、Azure App Service、Azure Container Apps、仮想マシン、ネットワーク、ストレージなど、任意のAzureリソースの種類で動作します。 ログとメトリックが Azure Monitor および Application Insights に存在する場合、エージェントはコネクタのセットアップを必要とせず、すぐに問題の調査を開始できます。 コネクタは、エージェントがシステム outside Azure に到達する必要がある場合に重要になります。

コネクタが提供するもの

コネクタは、エージェントに与えるものに基づいて、データ ソース、ソース コードと知識、コラボレーション ツール、カスタム コネクタの 4 つのカテゴリに分類されます。

データ ソース

これらのソースには、データ ストアからのクエリ ログ、メトリック、テレメトリを指定できます。

コネクタ 提供される内容
Log Analytics エージェントがログ データに関する永続的なコンテキストを持ち、事前にクエリを実行できるように、特定のワークスペースを接続します。
Application Insights エージェントがアプリケーション テレメトリに関する永続的なコンテキストを持つよう、特定の Application Insights リソースを接続します。
データベース クエリ (Azure Data Explorer) Kusto クラスターに対して定義済みの KQL クエリを実行します。
データベースのインデックス作成 (Azure Data Explorer) エージェントがクエリを動的に生成できるように、Kusto スキーマを自動学習します。

ヒント

エージェントは、組み込みのツールを使用して、Log Analyticsワークスペースまたは Application Insights リソースに対してクエリを実行できます。コネクタは必要ありません。 Log Analytics または Application Insights のコネクタを追加すると、さらに一歩進んで、エージェントが特定のワークスペースを継続的に認識できるようになり、それらのデータがエージェントのアンビエント コンテキストに含まれるようになります。 また、このコネクタを使用すると、接続されているリソース全体で、MCP ベースの高度な診断が可能になります。

ソース コードと知識

システムに関するエージェント コンテキスト (コード、Wiki、ドキュメント) を指定します。

コネクタ 提供される内容
GitHub MCP サーバー リポジトリ、問題、プル要求、Wiki ページへのアクセス。
GitHub OAuth OAuth 認証フローによる GitHub へのアクセス
Azure DevOps の OAuth OAuth 認証による Azure DevOps へのアクセス。
ドキュメント (Azure DevOps) Azure DevOps Wiki にインデックスを付け、検索します。

これらのコネクタを使用すると、エージェントはエラー パターンのコードを検索し、Wiki ドキュメントを読むことができます。 エージェントは、トラブルシューティング中に API ドキュメントを参照し、インシデントを関連するプル要求に接続することもできます。

コラボレーション ツール

チームが既に使用しているチャネルを通じて、エージェントが結果を伝えてみましょう。

コネクタ 提供される内容
通知を送信 (Teams) 結果と更新を Teams チャネルに投稿します。
電子メールの送信 (Outlook) 電子メール調査の概要とレポート。

カスタム コネクタ (MCP サーバー)

モデル コンテキスト プロトコル (MCP) サーバーを使用すると、監視プラットフォーム、ソース コード リポジトリ、チケット システム、カスタム API など、任意のシステムにエージェントを接続できます。 エージェントは、接続されたサーバーからツールを自動的に検出し、60 秒のハートビートで接続の正常性を監視し、一時的な障害から自動的に回復します。

2 種類のトランスポートによって、すべてのデプロイ モデルがカバーされます。リモート クラウド サービスの Streamable-HTTP と、エージェントと共に実行されているローカル プロセス用の stdio です。 GitHub、Datadog、Splunk、New Relic などのリソース用の構成済みパートナー コネクタでは、ワンクリックでセットアップできます。

MCP アーキテクチャ、トランスポートの種類、パートナー コネクタ、正常性の監視、およびツール管理の完全なガイドについては、 MCP コネクタとツールを参照してください。

最初の MCP コネクタを設定するには、「 MCP コネクタのセットアップ」を参照してください。

コネクタの参照と管理

折りたたみ可能なカテゴリ グループに編成されたコネクタを表示するには、 Builder>Connectors に移動します。 このページでは、すべてのグループが既定で展開されます。

Category 含まれるもの
コード リポジトリ GitHub、Azure DevOps、ソース コード、およびドキュメント コネクタ。
通知 Teams と Outlook のメッセージング コネクタ。
Telemetry Azure Data Explorer、Datadog、Dynatrace、Elasticsearch、New Relic、Splunk、およびその他の監視コネクタ。
Other 他のカテゴリに適合しない汎用 MCP サーバーとコネクタ。

各カテゴリ ヘッダーには、そのグループ内のコネクタの数が表示されます。 カテゴリを折りたたむと、そのグループ内のコネクタに接続の問題がある場合、赤いバッジが表示されます。 すべてのセクションを展開することなく、問題を一目で見つけることができます。

ツール バー コントロールを使用してビューを管理します。

  • すべてのカテゴリ グループを一度に切り替えるには、[すべて展開] または [すべて折りたたみ] を選択します。
  • 特定のカテゴリ のコネクタのみを表示するカテゴリ フィルター。
  • 名前 でコネクタを検索します (キーワード検索用のフラット リストに切り替えます)。

少なくとも 1 つのコネクタを含むカテゴリのみが表示されます。 コネクタを名前で検索すると、ページがフラット リスト ビューに切り替わり、フィルター処理が高速化されます。

コネクタを構成できるユーザー

コネクタを管理するには、エージェントに対する書き込みアクセス許可が必要です。 次の表は、このアクセス許可を持つロールを示しています。

役割 コネクタを構成できますか?
SRE エージェント管理者 はい
SRE エージェント標準ユーザー いいえ (表示のみ)
SRE エージェント リーダー いいえ (表示のみ)

一部のコネクタは、セットアップ時に、外部システムで適切なアクセス許可を持つユーザー (たとえば、GitHub コネクタのGitHub組織メンバー) からの OAuth 同意を必要とします。 この同意は、SRE エージェント ロールではなく、 外部 サービスのアクセス許可に関する同意です。

エージェントのマネージド ID (Azure Data Explorer など) を使用するコネクタの場合、外部システムの管理者は、許可されている ID を一覧表示する必要があります。

コネクタを構成すると、すべてのエージェント ユーザーに自動的にメリットが得られます。 エージェントに質問するだけで、エージェントはバックグラウンドで使用可能なコネクタを使用します。

コネクタとカスタム エージェント

特殊化されたカスタム エージェントに特定の MCP ツールを割り当てることができます。 データベースのトラブルシューティングを行うカスタムエージェントはKustoツールを使用でき、一方で、デプロイ用のカスタムエージェントはGitHubにアクセスできる。 この方法では、各カスタム エージェントに集中し続け、ツールの数が多くなりすぎないようにします。

ポータル ツール ピッカーでツールを個別に割り当てるか、YAML でワイルドカード パターン (connection-id/*) を使用してサーバーからすべてのツールを一度に追加します。 ツールの割り当てとワイルドカード構文の詳細については、 MCP コネクタとツールに関するページを参照してください。

ポータルで、 Builder>Custom エージェント ビルダーに移動します。 カスタム エージェントを作成または編集し、[ 詳細設定] で [ ツールの選択] を選択します。 ツール ピッカーには、MCP 接続別にグループ化されたツールが表示されます。 カスタム エージェントに必要なものを選択します。

YAML で、各ツールを完全な名前で一覧表示します。

mcp_tools:
  - azure-data-explorer_kusto_query
  - azure-data-explorer_kusto_table_list
  - azure-data-explorer_kusto_table_schema

MCP サーバーからすべてのツールを追加する (ワイルドカード)

MCP サーバーが多数のツールを公開していて、カスタム エージェントで必要なすべてのツールが必要な場合は、各ツールを個別に一覧表示するのではなく、ワイルドカード パターンを使用します。

mcp_tools:
  - azure-data-explorer/*

{connection-id}/* パターンでは、その MCP 接続からすべてのツールが追加されます。 エージェントは起動時にワイルドカードを展開します。 たとえば、azure-data-explorer/* は、azure-data-explorer という名前の接続に登録されているすべてのツールに対応します（リリース 26.4.16.0 の時点で、Kusto コネクタを使用する Azure MCP のデフォルトとして設定されている）。 コネクタに付けた名前で置き換えてください。

ワイルドカードは、個々のツール名と組み合わせることができます。

mcp_tools:
  - azure-data-explorer/*  # All tools from the Kusto connection
  - grafana-mcp_dashboard  # One specific tool from Grafana

注

このパターンは、フォワードスラッシュ（/）を含めて {connection-id}/* を使用する必要があります。 azure-data-explorer* (スラッシュなし) などのパターンは、ワイルドカードではなく、正確なツール名として扱われます。

次の表は、個々のツールの選択とワイルドカードの方法を比較しています。

方法 いつ使用するか
個々のツール カスタム エージェントがアクセスできるツールを正確に制御する必要があります。
ワイルドカード (connection-id/*) MCP サーバーを信頼し、後で追加するツールを含むすべてのツールが必要です。
Mixed あるサーバーのすべてのツールと、別のサーバーの特定のツールが必要です。

ワイルドカードを使用する理由 MCP サーバーが新しいツールを追加すると、カスタム エージェントを再構成することなく、ワイルドカードによって自動的に選択されます。 個々のツールを選択すると、正確な制御が可能になります。 ワイルドカードを使うと、自動的にカバー範囲が提供されます。

MCP ツールの準備がまだできていない場合

エージェントの起動時に MCP サーバーの準備ができていない場合、エージェントはそのサーバーからツールにアクセスできません。 エージェントは、この条件を巧みに処理します。 未解決のワイルドカードがある、または必要なツールが不足しているカスタム エージェントは保留され、エージェントが MCP 接続を確立した後に自動的に読み込まれます。 手動で操作する必要はありません。

詳細については、「 カスタム エージェント」を参照してください。

次のステップ

MCP コネクタを設定する

関連するコンテンツ

リソース 共同作業の重要性
インシデント プラットフォーム エージェントがインシデントを自動的に受信して対応する方法。
ソース コードの接続 GitHubコネクタまたはAzure DevOps コネクタを設定します。
MCP コネクタを設定する カスタム MCP サーバーを追加します。
カスタム エージェント 集中型コネクタ アクセスを使用して特殊なエージェントを作成します。
アクセス許可 エージェントの Azure リソースへのアクセスを構成します。
  • Last updated on