Azure Monitor およびワークブックのための Azure MCP Server ツール

Azure モデル コンテキスト プロトコル (MCP) サーバーを使用すると、自然言語プロンプトを使用して Azure Monitor とワークブックのリソースを管理できます。 Log Analytics ワークスペースのクエリ、運用データの分析、リソース正常性の監視、パフォーマンス メトリックの取得、可用性 Web テストの管理、インストルメンテーション ワークフローの調整、Azure Monitor ワークブックの管理を行うことができます。

Azure Monitor は、アプリケーションとサービスの可用性とパフォーマンスを最大化するのに役立ちます。 クラウドおよびオンプレミス環境からのテレメトリを収集、分析、および操作するための包括的なソリューションが提供されます。

ブックは、データ分析と、Azure ポータル内での豊富なビジュアル レポートの作成のための柔軟なキャンバスを提供します。 これにより、Azure全体から複数のデータ ソースを活用し、それらを統合された対話型エクスペリエンスに組み合わせることができます。 ワークブックを使用すると、複数の種類の視覚化や分析を組み合わせることができるため、フリーフォーム探索に適しています。 詳細については、Azure Monitor ワークブックのドキュメントを参照してください。

注

Tool パラメーター: Azure MCP サーバー ツールは、タスクを完了するために必要なデータのパラメーターを定義します。 これらのパラメーターの一部は、各ツールに固有であり、ここに記載されています。 その他のパラメーターはグローバルであり、すべてのツールで共有されます。 詳細については、「 ツールパラメーター」を参照してください。

アクティビティ ログ: アクティビティ ログを取得する

指定した Azure リソースに対する数時間前までの Azure Monitor アクティビティ ログを一覧表示します。 このツールは、リソースのデプロイ履歴、構成の変更、およびアクセス パターンを理解するのに役立ちます。 タイムスタンプ、操作名、状態、および呼び出し元情報を含むアクティビティ ログ イベントが返されます。 結果を使用して、失敗したデプロイ、予期しない変更、またはアクセスの問題を調査します。

プロンプトの例を次に示します。

  • "リソース 'webapp-prod' の過去 '720' 時間のアクティビティ ログを一覧表示します。"
パラメーター 必須または省略可能 Description
リソース名 必須 アクティビティ ログを取得するAzure リソースの名前。
イベント レベル オプション 取得するアクティビティ ログのレベル。 有効なレベルは、 Critical、 Error、 Informational、 Verbose、 Warningです。 指定しない場合は、すべてのレベルを返します。
Hours オプション 現在から遡ってアクティビティログを取得する時間数。
リソースの種類 オプション Azure リソースの種類 (例: 'Microsoft.Storage/storageAccounts')。 これは、同じ名前の複数のリソース間であいまいさを解消するために必要な場合にのみ指定します。
上位 オプション 取得するアクティビティ ログの最大数。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

Web テスト: Web テストを作成または更新する

モデル コンテキスト プロトコル (MCP) ツールの一部であるこのツールは、エンドポイントの可用性を確認するために、Azure Monitorで標準 Web テストを作成または更新します。 URL、頻度、場所、予想される応答などの監視設定を指定します。 テストが存在しない場合は、このツールによって作成されます。それ以外の場合は、既存のテストを新しい設定で更新します。

プロンプトの例を次に示します。

  • リソース グループ 'rg-prod-monitoring' にある Webtest リソース 'webtest-prod-availability' を使用して新しい Standard Web テストを作成し、'/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod' の AppInsights コンポーネントに関連付けます。
  • 既存のスタンダードウェブテストを、リソースグループ「rg-prod-monitoring」のWebテストリソース「webtest-prod-availability」に対して更新し、AppInsightsコンポーネント「/subscriptions/12345678-1234-1234-1234-123456789abc/resourceGroups/rg-ai/providers/microsoft.insights/components/appinsights-prod」とリンクします。
パラメーター 必須または省略可能 Description
リソース グループ 必須 Azure リソース グループの名前。
Webtest リソース 必須 操作する Web テスト リソースの名前。
Appinsights コンポーネント オプション Web テストに関連付ける Application Insights コンポーネントのリソース ID。
説明 オプション Web テストの簡単な説明。
有効 オプション Web テストが有効かどうか。
予期される状態コード オプション 期待される HTTP ステータス コード。
リダイレクトに従う オプション HTTP リダイレクトに従うかどうか。
頻度 オプション テスト頻度 (秒単位)。 サポートされる値: 300、600、900。
Headers オプション コンマ区切りの KEY=VALUE ペアとして要求に含める HTTP ヘッダー。
HTTP 動詞 オプション get や post など、使用する HTTP メソッド。
状態コードを無視する オプション 状態コードの検証を無視するかどうかを指定します。
場所 オプション Web テスト リソースが作成される場所。 これは Application Insights コンポーネントの場所と一致する必要があります。
要求の解析 オプション 依存する要求を解析するかどうか。
リクエスト本文 オプション 要求と共に送信する本文。
要求 URL オプション テストする絶対 URL。
再試行が有効 オプション 再試行が有効かどうか。
SSL チェック オプション SSL 証明書を検証するかどうか。
SSL 有効期間チェック オプション SSL 証明書の有効期間を確認する日数。
タイムアウト オプション 要求タイムアウト (秒単位)。 サポートされる値: 30、60、90、120。
Web テスト名 オプション Web テスト リソース内のテストの名前。
Web テストの場所 オプション テストを実行する場所のコンマ区切りの一覧。 可用性テストにおける地理的ロケーションの人口タグを参照します。
Webtest オプション Web テスト構成。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
✅ ✅ ❌ ❌ ❌ ❌

Web テスト: Web テストを取得する

このツールは、特定の Web テストの詳細を取得するか、すべての Web テストを一覧表示します。 Webtest リソースを指定すると、このツールはその Web テストの詳細情報を返します。 Webtest リソースを指定しない場合、このツールはサブスクリプション内のすべての Web テストの一覧を返し、リソース グループで一覧をフィルター処理できます。

プロンプトの例を次に示します。

  • "リソース グループ 'rg-monitoring' のサブスクリプションで Webtest リソース 'webtest-prod' の Web テストの詳細を取得します。"
  • "サブスクリプション内のすべての Web テスト リソースを一覧表示します。"
  • "リソース グループ 'rg-prod' のサブスクリプション内のすべての Web テスト リソースを一覧表示します。"
パラメーター 必須または省略可能 Description
Webtest リソース オプション 操作する Web テスト リソースの名前。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: ワークスペースを一覧表示する

このツールは、サブスクリプション内Log Analyticsワークスペースを一覧表示します。 各ワークスペースの名前、ID、場所、およびその他のキー プロパティを取得します。 ログのクエリを実行したり、ワークスペースの設定を調べたりする前に、ワークスペースを識別するために使用できます。

プロンプトの例を次に示します。

  • "私のサブスクリプション内のLog Analyticsワークスペースを一覧表示します。"
  • 自分の Log Analytics ワークスペースを表示します。
  • 私のサブスクリプションでLog Analyticsワークスペースを取得します。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: テーブルを一覧表示する

このツールは、Log Analytics ワークスペース内のすべてのテーブルを一覧表示します。 たとえば、リソース グループ 'rg-monitoring' のワークスペース 'prod-law' のテーブルを一覧表示して、使用可能な列とデータ型をプレビューします。 Kusto クエリ言語 (KQL) クエリの作成に使用するテーブル名とスキーマが返されます。 テーブルの種類 ( CustomLog や AzureMetricsなど) でフィルター処理できます。

プロンプトの例を次に示します。

  • リソース グループ 'rg-prod' の Log Analytics ワークスペース 'prod-law' に含まれるテーブルのうち、種類が 'CustomLog' であるすべてのテーブルを一覧表示します。
  • ワークスペース 'f1b2c3d4-5678-90ab-cdef-1234567890ab' が属するリソースグループ 'rg-monitoring' 内のテーブルタイプ 'AzureMetrics' のテーブルを表示してください。
パラメーター 必須または省略可能 Description
リソース グループ 必須 Azure リソース グループの名前。
ワークスペース名 必須 Log Analytics ワークスペース ID または名前。 一意識別子 (GUID) またはワークスペースの表示名のいずれかを指定できます。
テーブルの種類です。 必須 絞り込み対象のテーブルの種類。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: テーブルの種類を取得する

このモデル コンテキスト プロトコル (MCP) ツールは、Azure Log Analytics ワークスペースで使用可能なテーブルの種類を一覧表示します。 テーブル型の名前を返します。 これらの名前は、Azure Monitor ログに対してクエリを記述するときに使用できます。

プロンプトの例を次に示します。

  • "リソース グループ 'rg-prod' Log Analyticsワークスペース名 'prod-law-01' で使用可能なすべてのテーブルの種類を一覧表示します。"
  • "リソース グループ 'rg-logs' のワークスペース名 'analytics-workspace' Log Analyticsで使用できるテーブルの種類は何ですか?
パラメーター 必須または省略可能 Description
リソース グループ 必須 Azure リソース グループの名前。
ワークスペース名 必須 Log Analytics ワークスペースの名前または ID。 ワークスペース GUID または表示名を使用できます。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: ワークスペース ログのクエリを実行する

Kusto クエリ言語 (KQL) を使用して、Log Analytics ワークスペース全体のログをクエリします。 このツールは、ワークスペース内のすべてのリソースとテーブルのログを返す、ワークスペース全体のクエリを実行します。 このツールは、モデル コンテキスト プロトコル (MCP) ツールの一部です。 たとえば、"ワークスペース内のすべてのエラーを表示する"、"過去 24 時間以内にワークスペースで発生した内容"、"ワークスペース全体で失敗した要求を一覧表示する" という質問を行うことができます。

プロンプトの例を次に示します。

  • "リソース グループ 'rg-prod' の Log Analytics ワークスペース 'my-workspace' のテーブル 'Syslog' からクエリ 'errors' を含むログを表示します。"
パラメーター 必須または省略可能 Description
クエリ 必須 Log Analytics ワークスペースに対して実行する Kusto クエリ言語 (KQL) クエリ。 定義済みのクエリは名前で使用できます。 recent TimeGenerated で並べ替えられた最新のログが表示されます。 errors には、エラー レベルのログが TimeGenerated 順に表示されます。 または、カスタム KQL クエリを指定します。
リソース グループ 必須 Azure リソース グループの名前。
テーブル名 必須 ワークスペース内でクエリを実行するテーブルの名前。
ワークスペース名 必須 Log Analytics ワークスペース ID または名前。 グローバル一意識別子 (GUID) またはワークスペースの表示名のいずれかを指定できます。
Hours オプション 現在時刻からさかのぼってクエリする時間数。
制限 オプション 返される結果の最大数。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

Log Analytics: リソース ログのクエリを実行する

Kusto クエリ言語 (KQL) を使用して、Log Analytics ワークスペース内の特定のAzure リソースの診断ログとアクティビティ ログを照会します。 このツールは、指定したリソースに対して結果をフィルター処理し、選択したテーブルに対して指定された KQL クエリを実行します。 たとえば、"過去 24 時間のリソース 'app-monitor' のログを表示する" というメッセージを表示します。

プロンプトの例を次に示します。

  • テーブル 'AzureDiagnostics' で、リソース ID '/subscriptions/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1/resourceGroups/rg-prod/providers/Microsoft.Compute/virtualMachines/my-vm' のログをクエリ 'recent' で表示します。
パラメーター 必須または省略可能 Description
クエリ 必須 Log Analytics ワークスペースに対して実行する KQL クエリ。 定義済みのクエリを名前で使用できます。 recent TimeGenerated によって並べ替えられた最新のログが表示されます。 errors には、TimeGenerated で並べ替えられたエラー レベルのログが表示されます。 それ以外の場合は、カスタム KQL クエリを指定します。
リソース ID 必須 クエリするリソースの Azure リソース ID。 例: /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.OperationalInsights/workspaces/<ws>。
テーブル名 必須 ワークスペース内でクエリを実行するテーブルの名前。
Hours オプション 現在時刻からさかのぼってクエリする時間数。
制限 オプション 返される結果の最大数。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

正常性モデル: 正常性モデルを一覧表示する

Azure Monitor正常性モデル リソース内のすべての正常性モデルを一覧表示します。 このツールは、アプリケーション レベルの正常性を監視するために使用可能な正常性モデルを検出するのに役立ちます。 モデル コンテキスト プロトコル (MCP) ツールは、基本的なリソースの可用性ではなく、カスタム正常性モデルに基づいてアプリケーション レベルの正常性を報告します。 基本的なリソースの可用性には、Azure Resource Healthを使用します。 Log Analytics ワークスペースのログに対してクエリを実行するには、azmcp_monitor_workspace_log_query を使用します。 特定のAzure リソースのログを照会するには、azmcp_monitor_resource_log_query を使用します。

プロンプトの例を次に示します。

  • "リソース グループ 'rg-prod' の正常性モデル リソース 'app-health-monitor' 内のすべての正常性モデルを一覧表示します。"

CLI コマンドの例

azmcp monitor healthmodels list \
  [--resource-group <resource-group>]

ツール注釈ヒント:

破壊的: ❌ | 冪等: ✅ | オープンワールド: ❌ | 読み取り専用: ✅ | シークレット: ❌ | ローカル必須: ❌

正常性モデル: 正常性モデルを取得する

Azure Monitor の正常性モデル リソースから、名前で特定の正常性モデルを取得します。 このツールは、特定の正常性モデルの正常性状態と最近の正常性イベントを返します。 モデル コンテキスト プロトコル (MCP) ツールは、基本的なリソースの可用性ではなく、カスタム正常性モデルに基づいてアプリケーション レベルの正常性を報告します。 基本的なリソースの可用性には、Azure Resource Healthを使用します。 Log Analytics ワークスペースのログに対してクエリを実行するには、azmcp_monitor_workspace_log_query を使用します。 特定のAzure リソースのログを照会するには、azmcp_monitor_resource_log_query を使用します。

プロンプトの例を次に示します。

  • リソース グループ 'rg-prod' の正常性モデル リソース 'app-health-monitor' から、正常性モデル 'order-service-health' を取得します。
パラメーター 必須または省略可能 Description
ヘルスモデル 必須 取得する正常性モデルの名前。
リソース グループ 必須 Azure リソース グループの名前。

注

3.0.0-beta.24 以前からの移行:monitor healthmodels entity get コマンドは 3.0.0-beta.25 で削除されます。 monitor healthmodels listを使用してすべての正常性モデルを一覧表示するか、monitor healthmodels getを使用して特定の正常性モデルを名前で取得します。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

メトリクス: クエリ メトリクス

リソースのAzure Monitorメトリックをクエリします。 このツールは、指定されたメトリックの時系列データを返し、リソースのパフォーマンスと可用性を分析するのに役立ちます。 このツールは、モデル コンテキスト プロトコル (MCP) ツールの一部です。

プロンプトの例を次に示します。

  • "メトリック 'requests/duration' とメトリック名前空間 'microsoft.insights/components' を使用して、Application Insights リソース 'appinsights-prod' のパフォーマンスの傾向と応答時間を分析します。"
  • "メトリック名前空間 'microsoft.insights/components' を使用して、Application Insights リソース 'appinsights-staging' の可用性メトリック 'availabilityResults/availabilityPercentage' を確認してください。
  • "リソース 'appinsights-prod' に対してメトリック名前空間 'microsoft.insights/components' を使用し、集計 'Average' と間隔 'PT1M' でメトリック 'requests/duration' を取得します。"
  • "メトリック 'requests/failed,exceptions/count' とメトリック名前空間 'microsoft.insights/components' を使用して、Application Insights リソース 'appinsights-prod' のエラー率と失敗した要求を調査します。"
  • メトリック名前空間 'microsoft.insights/components'、間隔 'PT5M' を使用して、リソースの種類 'Microsoft.Insights/components' のリソース 'appinsights-qa' に対するメトリック 'requests/count' をクエリします。
  • Application Insights リソース 'appinsights-prod' とメトリック名前空間 'microsoft.insights/components' に対して、メトリック 'requests/count' を使用し、集約方法 'Count' を用いた場合の 1 秒あたりの要求割合はどれくらいですか？
パラメーター 必須または省略可能 Description
メトリック名 必須 クエリするメトリックの名前 (コンマ区切り)。
メトリック名前空間 必須 クエリを実行するメトリック名前空間。 azmcp-monitor-metrics-definitions ツールからこの値を取得します。
リソース名 必須 メトリックのクエリを実行するAzure リソースの名前。
集約 オプション 使用する集計の種類 (Average、Maximum、Minimum、Total、Count など)。
終了時刻 オプション ISO 形式のクエリの終了時刻 (たとえば、 2023-01-01T00:00:00Z)。 既定値は現在時点です。
フィルター オプション メトリック クエリに適用する OData フィルター。
Interval オプション データ ポイントの時間間隔 (たとえば、1 時間の PT1H 、5 分間 PT5M )。
最大バケット数 オプション 返されるタイムバケットの最大数。 既定値は 50 です。
リソースの種類 オプション Azure リソースの種類 (例: Microsoft.Storage/storageAccounts、Microsoft.Compute/virtualMachines)。 指定しない場合、ツールはリソース名から型の推論を試みます。
開始時刻 オプション ISO 形式のクエリの開始時刻 (たとえば、 2023-01-01T00:00:00Z)。 既定値は 24 時間前です。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

メトリック: メトリック定義を一覧表示する

このツールは、Azure リソースのメトリック定義を一覧表示します。 名前空間、説明、集計の種類など、各メトリックに関するメタデータが返されるため、リソースに対してクエリを実行するメトリックを決定できます。

プロンプトの例を次に示します。

  • "リソース名 'app-insights-prod' のメトリック定義を取得します。"
  • リソース名 'mystorageacct' を持つリソースの種類 'Microsoft.Storage/storageAccounts' とメトリック名前空間 'Storage' のメトリック定義を一覧表示します。
  • "検索文字列 'cpu' を使用してリソース名 'vm-prod-01' のメトリック定義を表示し、'20' を制限します。"
パラメーター 必須または省略可能 Description
リソース名 必須 メトリックのクエリを実行するAzure リソースの名前。
制限 オプション 返されるメトリック定義の最大数。 既定値は 10 です。
メトリック名前空間 オプション クエリを実行するメトリック名前空間。 azmcp-monitor-metrics-definitions ツールからこの値を取得します。
リソースの種類 オプション Azure リソースの種類 (例: Microsoft.Storage/storageAccounts、Microsoft.Compute/virtualMachines)。 指定しない場合、ツールはリソース名からリソースの種類を推測しようとします。
検索文字列 オプション メトリック定義をフィルター処理する文字列。 このフィルターは、メトリック名と説明に対して大文字と小文字を区別しない照合を実行します。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

インストルメンテーション: 学習リソースを取得する

このツールは、Azure Monitorインストルメンテーションで使用可能なすべての学習リソースを一覧表示するか、パスによって特定のリソースのコンテンツを取得します。 既定では、ツールはすべてのリソース パスを返します。 パスを指定すると、ツールは完全なリソース コンテンツを返します。 アプリケーションをインストルメント化するには、オーケストレーター開始ツールを使用します。

プロンプトの例を次に示します。

  • "パス 'onboarding/get-started.md' でオンボード ラーニング リソースを取得します。"
  • "パス 'onboarding/quickstart.md' にあるAzure Monitorオンボード学習リソースの内容を表示してください。"
  • "パス 'samples/instrumentation-guide.html' にあるAzure Monitor学習リソース ファイルの内容を取得します。
  • Azure Monitor のオンボーディングに関するすべての学習リソースを一覧表示してください。
  • "Azure Monitor インストルメンテーションのすべてのラーニング リソース パスを表示します。"
  • Azure Monitor インストルメンテーションのオンボードに利用可能な学習リソースは何がありますか？
パラメーター 必須または省略可能 Description
Path オプション 学習リソースパス。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ✅

インストルメンテーション: オーケストレーションを開始する

Azure Monitorをインストルメント化するモデル コンテキスト プロトコル (MCP) ツールについては、ここから始めます。 このツールはワークスペースを分析し、最初に実行するアクションを返します。 アクションを実行した後、orchestrator-next を呼び出して続行します。 instruction フィールドのアクションに正確に従います。

プロンプトの例を次に示します。

  • "ワークスペース パス '/home/dev/workspace-monitoring' の Azure Monitor のインストルメンテーション オーケストレーションを開始する。"
  • ワークスペースパス '/src/projects/my-app-workspace' を分析し、Azure Monitor インストルメンテーションプロセスの最初のステップを返します。
  • 「ワークスペース パス '/workspace/my-app' のプロジェクトの Azure Monitor ガイド付きオンボーディングを開始し、最初の手順を教えてください。」
パラメーター 必須または省略可能 Description
ワークスペース のパス 必須 ワークスペース フォルダーへの絶対パス。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ❌ ❌ ❌ ❌ ✅

インストルメンテーション: オーケストレーションを続行する

現在のインストルメンテーション アクションを完了した後、次のインストルメンテーション アクションを取得します。

このツールは、モデル コンテキスト プロトコル (MCP) スイートの一部です。

前の応答から正確な instruction を実行した後、このツールを実行して次のアクションを受け取ります。

想定されるワークフロー:

  1. orchestrator-start または orchestrator-next からアクションを受け取ります。
  2. instructionフィールドを正確に実行します。
  3. このツールは、簡潔な Completion note で実行して、次のアクションを取得します。

戻り値: 次に実行するアクション、またはすべてのステップが完了した場合のcomplete ステータス。

プロンプトの例を次に示します。

  • "前の Azure Monitor インストルメンテーション 手順を完了した後、完了メモ 'UseAzureMonitor() を Program.cs に追加しました" と共に、セッション ID 'session-abc123' の次のアクションを取得します。"
  • 「完了メモ 'Ran dotnet add package Microsoft.ApplicationInsights' があるセッション ID 'workspace/session-2026' に関するオンボーディングの次のアクションを取得します。」
  • "前のインストルメンテーション 手順を完了した後、セッション ID 'session-789xyz' の次のステップを返します。完了メモ 'Application Insights を有効にするために appsettings.json が更新されました"。
パラメーター 必須または省略可能 Description
完了メモ 必須 実行した内容を説明する 1 つの文 (たとえば、'Ran dotnet add package command' や 'Added UseAzureMonitor() to Program.cs' など)。
セッション ID 必須 orchestrator-start からの sessionId として返されるワークスペース パス。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ❌ ❌ ❌ ❌ ✅

インストルメンテーション: ブラウンフィールド分析を送信する

orchestrator-startが状態analysis_neededを返した後、ブラウンフィールド コード分析結果を送信します。 このツールは、モデル コンテキスト プロトコル (MCP) ワークフローの一部です。 このツールを呼び出す前に、ワークスペースのソース ファイルをスキャンし、分析テンプレートに入力する必要があります。 このツールが成功したら、 orchestrator-nextに進みます。

プロンプトの例を次に示します。

  • "Send brownfield code analysis findings JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' to Azure Monitor instrumentation session 'workspace-7a3b' after analysis was requested."
  • "Continue migration orchestration by submitting findings JSON '{"serviceOptions":{"found":true,"details":"AddApplicationInsightsTelemetry used"},"initializers":[],"processors":[],"clientUsage":null,"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":null}' to session 'sess-01234'."
  • "Send completed brownfield telemetry analysis as findings JSON '{"serviceOptions":null,"initializers":null,"processors":null,"clientUsage":{"found":true},"sampling":{"found":false,"hasCustomSampling":false},"telemetryPipeline":null,"logging":{"found":true}}' for onboarding session 'session-9f3b'."
パラメーター 必須または省略可能 Description
結果 JSON 必須 ブラウンフィールド分析結果を含む JSON オブジェクト。 必須プロパティ: serviceOptions (AddApplicationInsightsTelemetry() の分析結果から得られたサービス オプションの検出結果、見つからない場合は null), initializers (ITelemetryInitializer または IConfigureOptions <TelemetryConfiguration> 実装の分析結果から得られたテレメトリ初期化子に関する検出結果、見つからない場合は null), processors (ITelemetryProcessor 実装の分析結果から得られたテレメトリ プロセッサーの検出結果、見つからない場合は null), clientUsage (直接的な TelemetryClient 使用状況の分析結果から得られた TelemetryClient 使用状況の検出結果、見つからない場合は null), sampling (カスタム サンプル構成の分析結果、カスタムサンプルが無い場合は null)、telemetryPipeline (マスタム ITelemetryChannel または TelemetrySinks 使用状況の検出結果、見つからない場合は null), logging (明示的なロガー プロバイダーとフィルターの分析結果、見つからない場合は null)。 コードベースに存在しないセクションの場合は、空の既定のオブジェクト (例: false または hasCustomSampling: false、null ではなく) を渡します。
セッション ID 必須 sessionIdからorchestrator-startとして返されるワークスペース パス。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ❌ ❌ ❌ ❌ ✅

インストルメンテーション: 送信拡張機能の選択

orchestrator-startが状態enhancement_availableを返した後、ユーザーの強化の選択を送信します。 拡張機能の選択肢をユーザーに提示し、選択した拡張キーを使用してこのツールを呼び出します。 redis,processorsなど、コンマ区切りのリストを渡すことで、複数の拡張機能を選択できます。 このツールが成功したら、 orchestrator-nextに進みます。

プロンプトの例を次に示します。

  • "拡張キー 'redis,processors' を Azure Monitor インストルメンテーション セッション ID 'workspaces/my-app/session-abc123' に送信します。"
  • "拡張キー 'redis' をセッション ID 'workspaces/prod-app/session-789' に送信して、インストルメンテーションの強化フローを続行します。"
  • "選択した拡張キー 'entityframework,otlp' を送信してセッション ID 'workspaces/onboard/session-456' をオンボードします。"
パラメーター 必須または省略可能 Description
強化キー 必須 コンマ区切りの 1 つ以上の拡張キー ( redis、 redis,processors、 entityframework,otlpなど)。
セッション ID 必須 sessionIdからorchestrator-startとして返されるワークスペース パス。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ❌ ❌ ❌ ❌ ✅

ワークブック: ワークブックをリスト化する

Azure Resource Graph を使用して、Azure のワークブックを検索し、高速なメタデータ クエリを実行します。 このツールは、さまざまなスコープにわたるワークブックの検出、フィルター、およびカウントに役立ちます。

id、name、location、category、タイムスタンプを含むワークブックのメタデータが返されます。 既定では、ブックの完全なコンテンツ (serializedData) は返されません。完全な内容を表示するには表示ツールを使用するか、Output format を fullに設定する必要があります。

既定では、現在の Azure コンテキスト (テナント/サブスクリプション) 内のワークブックが検索対象になります。 Resource groupを使用して、検索範囲を明示的に指定できます。 このツールは、既定でサーバー側の合計カウントを返します。 返される最大結果は 50 で、上限は 1000 です。これを Max resultsで調整します。 最小トークンの場合はOutput formatとしてsummaryを選択し、完全なfull出力にはserializedDataを選択します。

プロンプトの例を次に示します。

  • リソース グループ 'monitoring-rg' 内のすべてのワークブックを表示します。
  • "リソース グループ 'prod-rg' の共有ブックを一覧表示します。"
  • リソース グループ 'analytics-rg' で 2024-01-15 より後に変更されたワークブックはどれですか?
パラメーター 必須または省略可能 Description
リソース グループ オプション Azure リソース グループの名前。
カテゴリ オプション カテゴリー別に Workbooks をフィルター処理します (例: workbook、sentinel、TSG)。 指定しない場合は、すべてのカテゴリが返されます。
合計カウントを含める オプション 互換性があるすべてのワークブックの合計数を応答に含めます (既定値: true)。
Kind オプション 種類 (たとえば、shared、user) でワークブックをフィルターします。 指定しない場合は、すべての種類が返されます。
最大結果 オプション 返される結果の最大数 (既定値: 50、最大: 1000)。
変更後 オプション この日付より後に修正された Workbooks をフィルター処理します (ISO 8601 形式、たとえば、2024-01-15)。
名前に含まれるもの オプション 表示名にこのテキストが含まれているブックをフィルタリングします（大文字と小文字は区別されません）。
出力形式 オプション 出力形式: summary (ID と名前のみ、最小限のトークン)、 standard (コンテンツのないメタデータ、既定)、 full ( serializedDataを含む)。
ソース ID オプション ソース リソース ID (たとえば、/subscriptions/abc123/resourceGroups/prod/providers/Microsoft.Insights/components/myapp) でワークブックをフィルターします。 指定しない場合は、すべてのブックが返されます。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

ワークブック: ワークブックの詳細を表示する

Azure Resource Manager (ARM) API を使用して、serializedData コンテンツを含むワークブックの全詳細を取得します。 このコマンドを使用すると、視覚化 JSON を含む完全なブック定義を取得できます。

ワークブックのすべてのプロパティ、serializedData、タグ、およびETagを返します。 バッチ操作には複数の Workbook IDs を指定できます。 このコマンドは、個々のワークブックの部分的なエラーを報告します。 パフォーマンスを向上させるには、まずリスト ツールを使用してワークブックを見つけ、その後、特定のワークブックに対して「show」コマンドを使用します。

プロンプトの例を次に示します。

  • "リソース ID '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' のワークブックの詳細を表示してください。"
  • ワークブック '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' の完全な定義を取得します。
パラメーター 必須または省略可能 Description
ワークブック ID 必須 取得するワークブックのAzure リソース ID。 バッチ操作で複数の値をサポートします。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
❌ ✅ ❌ ✅ ❌ ❌

ワークブック: ワークブックを作成する

指定したリソース グループとサブスクリプションに新しいワークブックを作成します。 ブックの表示名とシリアル化された JSON コンテンツを設定できます。 このコマンドは、正常に完了すると、作成されたブック情報を返します。

プロンプトの例を次に示します。

  • "基本的なノートブックのシリアル化されたコンテンツを使用して、リソース グループ 'monitoring-rg' に 'Performance Dashboard' という名前の新しいブックを作成します。"
  • "VM メトリックを示すコンテンツを含むリソース グループ 'prod-rg' に 、"インフラストラクチャの概要" という名前のブックを作成します。"
パラメーター 必須または省略可能 Description
表示名 必須 ブックの表示名。
リソース グループ 必須 Azure リソース グループの名前。
シリアル化されたコンテンツ 必須 ワークブックの JSON コンテンツがシリアル化されました。
ソース ID オプション ワークブックに関連付けられたリソース ID。 既定では、これは azure monitor です。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
✅ ❌ ❌ ❌ ❌ ❌

ワークブック: ワークブックを更新する

新しい手順の追加、コンテンツの変更、または表示名の変更を行って、既存のAzure ブックのプロパティを更新します。 このアクションは、更新後のワークブックの詳細を返します。 ワークブックのリソース ID が必要であり、新しいシリアル化されたコンテンツまたは新しい表示名のいずれかを指定できます。

プロンプトの例を次に示します。

  • "表示名 'Monthly Report' の ワークブック '/subscriptions/abc123/resourceGroups/monitoring-rg/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' を更新します。"
  • ワークブック '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' のシリアル化されたコンテンツを変更して、新しいメトリック チャートを含めます。
パラメーター 必須または省略可能 Description
ワークブック ID 必須 更新するワークブックのAzureリソースID。
表示名 オプション ブックの表示名。
シリアル化されたコンテンツ オプション ワークブックの JSON でシリアル化されたコンテンツ。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
✅ ✅ ❌ ❌ ❌ ❌

ワークブック: ワークブックを削除する

Azure リソース ID で 1 つ以上のワークブックを削除します。 このコマンドは、ワークブックに対してソフト削除を実行し、90日間保持します。 必要に応じて、Azure ポータルからごみ箱から復元できます。

バッチ操作では、複数の Workbook IDs 値を指定できます。 このコマンドは、ブックごとの部分的なエラーを報告し、個々のエラーがバッチ操作全体に影響を与えないようにします。

詳細については、「Azure Monitor ワークブックの管理」を参照してください。

プロンプトの例を次に示します。

  • リソース ID '/subscriptions/abc123/resourceGroups/monitoring/providers/Microsoft.Insights/workbooks/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1' のワークブックを削除します。
  • リソース ID '/subscriptions/xyz789/resourceGroups/prod-rg/providers/Microsoft.Insights/workbooks/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2' と '/subscriptions/def456/resourceGroups/analytics-rg/providers/Microsoft.Insights/workbooks/c2c2c2c2-dddd-eeee-ffff-a3a3a3a3a3a3' のワークブックを削除します。
パラメーター 必須または省略可能 Description
ワークブック ID 必須 削除するワークブックのAzureリソースID。 バッチ操作で複数の値をサポートします。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須
✅ ✅ ❌ ❌ ❌ ❌

関連コンテンツ

  • Last updated on