次の方法で共有

Windows VM での Azure Monitor エージェントのインストールに関する問題のトラブルシューティング

この記事では、Azure Windows 仮想マシン (VM) で Azure Monitor エージェント (AMA) のインストールが失敗した場合の問題をトラブルシューティングするための詳細な手順について説明します。

Note

トラブルシューティング プロセスを完了するには、VM のリソース ID を把握し、そのオペレーティング システムへの管理アクセス権があることを確認します。

手順 1: VM が実行されていない場合は起動する

  1. Azure portal にサインインします。

  2. AMA エージェントがインストールされている VM を選択します。

  3. VM の Overview ページで、VM Status が Running かどうかを確認します。

    VM の状態を示すスクリーンショット。

    VM が実行されている場合は、「 手順 2: VM にマネージド ID があるかどうかを確認するに移動します。

    VM が実行されていない場合は、VM を起動し、完全に起動して動作するまで待ちます。

手順 2: VM にマネージド ID があるかどうかを確認する

  1. Azure portal にサインインします。

  2. AMA エージェントがインストールされている VM を選択します。

  3. [ Security ブレードで、 Identity を選択します

  4. "SystemAssigned" または "UserAssigned" ID が存在するかどうかを確認します。

    一方または両方の ID が存在する場合は、「 ステップ 3: 拡張機能が VM 構成に存在するかどうかを確認するに移動します。

    どちらも表示されていない場合 システム割り当てマネージド ID を有効にするか ユーザー割り当てマネージド ID を 割り当てます。

    環境に適した ID を判断するには、「 Azure リソースのマネージド ID とは何か」を参照してください。

既存の VM でシステム割り当てマネージド ID を有効にする

最初にプロビジョニングされていない VM でシステム割り当てマネージド ID を有効にするには、アカウントに 仮想マシン共同作成者 ロールの割り当てが必要です。 その他の Microsoft Entra ディレクトリ ロールを割り当てる必要はありません。

  1. VM が含まれる Azure サブスクリプションに関連付けられているアカウントを使用して、Azure Portal にサインインします。

  2. 目的の VM に移動し、 Identity を選択します。

  3. System assigned>Status で On を選択し、Save を選択します。

    システム マネージド ID を有効にする方法を示すスクリーンショット。

ユーザー割り当てマネージド ID を既存の VM に割り当てる

ユーザー割り当てマネージド ID を VM に割り当てるには、アカウントに Virtual Machine Contributor と Managed Identity Operator ロールの割り当てが必要です。 その他の Microsoft Entra ディレクトリ ロールを割り当てる必要はありません。

  1. VM が含まれる Azure サブスクリプションに関連付けられているアカウントを使用して、Azure Portal にサインインします。

  2. 目的の VM に移動し、 Identity>User assigned> + Add を選択します。

    ユーザー割り当て ID を追加する方法を示すスクリーンショット。

  3. VM に追加するユーザー割り当て ID を選択し、 追加を選択します。

    ユーザー割り当て ID が既に選択されていることを示すスクリーンショット。

手順 3: 拡張機能が VM 構成に存在するかどうかを確認する

  1. Azure Portal に移動します。

  2. VM を見つけます。

    1. 左側のメニューで、 仮想マシンを選択します。
    2. 確認する VM を一覧から見つけて選択します。

  3. VM の拡張機能を確認します。

    1. VM の左側のメニューで、Settings セクションの下にある Extensions + applications を選択します。

    2. Microsoft.Azure.Monitor.AzureMonitorWindowsAgent型の拡張機能を探します。

      AzureMonitorWindowsAgent 拡張機能を示すスクリーンショット。

    3. 拡張機能が存在する場合は、手順 4 に進みます。

      拡張機能が存在しない場合は、手順 5 に進みます。

  4. 拡張機能の状態を確認します。

    1. Microsoft.Azure.Monitor.AzureMonitorWindowsAgent拡張機能の Status 列を確認します。

    2. 状態が "プロビジョニングに成功しました" の場合は、手順 5 と 6 をスキップし、 手順 4: VM ゲスト エージェントが実行されているかどうかを確認します。

      AzureMonitorWindowsAgent 拡張機能の状態を示すスクリーンショット。

      状態が "プロビジョニングに成功しました" でない場合は、手順 5 と 6 に進みます。

  5. 拡張機能をインストールします。

    1. 追加 ボタンを選択します。
    2. AzureMonitorWindowsAgent を検索して選択します。
    3. プロンプトに従って、VM に拡張機能をインストールします。

  6. 拡張機能とその状態をもう一度確認します。

拡張機能がインストールされたら、手順 3 と 4 を繰り返して、拡張機能が存在し、状態が "プロビジョニングに成功しました" であることを確認します。

手順 4: VM ゲスト エージェントが実行されているかどうかを確認する

次のいずれかの方法を使用して、VM ゲスト エージェントの状態を確認します。

  • Azure portal を使用する。

    1. Azure Portal に移動します。
    2. VM を見つけます。
      1. 左側のメニューで、 仮想マシンを選択します。
      2. 確認する VM を一覧から見つけて選択します。
    3. VM の拡張機能を確認します。
      1. VM の左側のメニューで、Settings セクションの下にある Extensions + applications を選択します。
      2. Microsoft.Azure.Monitor.VirtualMachines.GuestHealth.GuestHealthWindowsAgent型の拡張機能を探します。
    4. 状態が "プロビジョニングに成功しました" であることを確認します。

  • Get-Service WindowsAzureGuestAgent PowerShell コマンドレットを実行し、コマンド出力のStatus列を確認します。

VM ゲスト エージェントが実行されている場合は、「 ステップ 5: VM ゲスト エージェントが拡張機能バイナリをダウンロードするかどうかを確認するに移動します。

手順 5: VM ゲスト エージェントが AMA 拡張機能バイナリをダウンロードするかどうかを確認する

  1. Azure ポータルに移動します:

  2. VM を見つけます。

    1. 左側のメニューで、 仮想マシンを選択します。
    2. 確認する VM を一覧から見つけて選択します。

  3. VM の拡張機能を確認します。

    1. VM の左側のメニューで、Settings セクションの下にある Extensions + applications を選択します。
    2. Microsoft.Azure.Monitor.AzureMonitorWindowsAgent型の拡張機能を探します。

  4. VM ゲスト エージェントのログを確認します。

    1. Support + troubleshootingで、Boot Diagnostics タブを開きます。
    2. Serial ログを選択して、VM のブート ログと拡張機能ログを表示します。
    3. Microsoft.Azure.Monitor.AzureMonitorWindowsAgent拡張機能に関連するログを探します。

  5. 拡張機能バイナリを確認します。

    ログにバイナリがダウンロードおよび抽出されたことを示す場合は、「 Step 6: VM ゲスト エージェントが拡張機能をインストールして有効にするかどうかを確認するに移動します。

    バイナリがない場合、VM ゲスト エージェントは拡張バイナリ ファイルを正常にダウンロードしません。 この場合は、手順 6 に進みます。

  6. VM ゲスト エージェントを再起動します。

    1. リモート デスクトップ プロトコル (RDP) を使用して VM に接続します。

    2. コマンド プロンプトまたは PowerShell ウィンドウを開きます。

    3. 次のコマンドを実行します。

      net stop WindowsAzureGuestAgent
net start WindowsAzureGuestAgent

  7. 拡張機能バイナリをもう一度確認します。

    前の手順 5 を繰り返して、再起動後にバイナリが正常にダウンロードおよび抽出されたかどうかを確認します。

手順 6: VM ゲスト エージェントに AMA 拡張機能がインストールされ、有効になっているかどうかを確認する

Azure VM ゲスト エージェントが拡張機能を正しくインストールして有効にしていることを確認するには、次の手順に従います。

  1. Azure Portal に移動します。

  2. VM を見つけます。

    1. 左側のメニューで、 仮想マシンを選択します。
    2. 確認する VM を一覧から見つけて選択します。

  3. VM に接続します。

    1. RDP を使用して VM に接続します。
    2. サインインする VM の IP アドレス、ユーザー名、パスワードを入力します。

  4. エクスプローラーを開き、C:\WindowsAzure\Logs\ ディレクトリに移動します。

  5. VM ゲスト エージェントのログを確認します。

    • WaAppAgent.log ファイルを開き、VM ゲスト エージェントのログを表示します。
    • 拡張機能の Microsoft.Azure.Monitor.AzureMonitorWindowsAgentに関連するログを探します。

  6. プラグイン環境のセットアップを確認します。

    プラグイン環境が設定されていることを示すログ エントリを確認します。

    [00000010] YYYY-MM-DDTHH:MM:SS.SSSZ [WARN] Setting up plugin environment (name: Microsoft.Azure.Monitor.AzureMonitorWindowsAgent, version: X.Y.Z.Z)., Code: 0

  7. プラグインのインストールを確認します。

    プラグイン インストーラーが実行されていることを示すログ エントリを探します。

    [00000010] YYYY-MM-DDTHH:MM:SS.SSSZ [WARN] Installing plugin (name: Microsoft.Azure.Monitor.AzureMonitorWindowsAgent, version: X.Y.Z.Z), Code: 0
[00000010] YYYY-MM-DDTHH:MM:SS.SSSZ [WARN] Started a process with the launch command C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\X.Y.Z.Z\AzureMonitorAgentExtension.exe, params: install.

  8. プラグインのインストール結果を確認します。

    インストール結果を示すログ エントリを確認します。

    [00000010] YYYY-MM-DDTHH:MM:SS.SSSZ [WARN] Installed plugin (name: Microsoft.Azure.Monitor.AzureMonitorWindowsAgent, version: X.Y.Z.Z), Code: 0

  9. コマンド実行ログを確認します。

    1. C:\WindowsAzure\Logs\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\{version}\ ディレクトリに移動します。
    2. CommandExecution*.logという名前のファイルを開き、インストールおよび有効化プロセス中に stdout または stderr メッセージがあるかどうかを確認します。

  10. プラグインが有効になっていることを確認します。

    プラグインが有効になっていることを示すログ エントリを探します。

    [00000010] YYYY-MM-DDTHH:MM:SS.SSSZ [WARN] Enabling plugin (handler name: Microsoft.Azure.Monitor.AzureMonitorWindowsAgent, extension name: , version: X.Y.Z.Z)., Code: 0
[00000010] YYYY-MM-DDTHH:MM:SS.SSSZ [INFO] Command C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\X.Y.Z.Z\AzureMonitorAgentExtension.exe of Microsoft.Azure.Monitor.AzureMonitorWindowsAgent has exited with Exit code: 0
[00000010] YYYY-MM-DDTHH:MM:SS.SSSZ [WARN] Setting the install state of the handler Microsoft.Azure.Monitor.AzureMonitorWindowsAgent_X.Y.Z.Z to Enabled

  11. 拡張機能の状態を確認します。

    1. C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\*\Status\ ディレクトリに移動します。
    2. *.statusという名前のファイルを開き、拡張機能の状態が Azure に送信されることを確認します。

  12. 問題を特定して解決します (問題が発生した場合):

    VM ゲスト エージェントのログに基づいて問題を特定して解決した後、 Step 7: AMA プロセスが開始されているかどうかを確認します。

    ヒント

    問題を解決しようとすると、Azure の公式ドキュメントを参照してさらにサポートを受けることができます。

    問題を特定または解決できない場合は、問題を検索するか、 Microsoft Q&A フォーラムでサポートを依頼。 さらに支援を求める前に、必要なログが収集されていることを確認してください。

手順 7: AMA プロセスが開始されているかどうかを確認する

  1. Azure Portal に移動します。

  2. VM を見つけます。

    1. 左側のメニューで、 仮想マシンを選択します。
    2. 確認する VM を一覧から選択します。

  3. VM に接続します。

    1. RDP を使用して VM に接続します。
    2. サインインする VM の IP アドレス、ユーザー名、パスワードを入力します。

  4. [タスク マネージャー] を開きます。

    サインインしたら、タスク バーを右クリックし、 Task Manager を選択します。 Ctrl+Shift+Esc を選択して、タスク マネージャーを直接開くこともできます。

  5. AMA プロセスを確認します。

    1. タスク マネージャーで、 Processes タブを選択します。
    2. 次のプロセスを探します。
    • AMAExtHealthMonitor
    • MonAgentHost
    • MonAgentLauncher
    • MonAgentManager

    Note

    MonAgentCore プロセスはこの一覧には含まれません。 これはエージェント構成の一部であるため、このプロセスを開始せずにインストールが成功する可能性があります。

  6. すべての AMA プロセスが実行されているかどうかを確認します。

    4 つのプロセス (AMAExtHealthMonitor、 MonAgentHost、 MonAgentLauncher、 MonAgentManager) がすべて一覧表示され、実行されている場合、エージェント プロセスは正常に開始されます。

次のステップ

高度なトラブルシューティングの手順

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティ サポートにお問い合わせください。 Azure フィードバック コミュニティに製品フィードバックを送信することもできます。