Windows オペレーティング システム (OS) の Azure Monitor エージェント トラブルシューティング ツールの使用方法

  • [アーティクル]

Azure Monitor エージェント (AMA) トラブルシューティング ツールは、エージェントに関する問題を特定し、一般的な正常性評価を実行する際に役立つように設計されています。 これは、エージェントが適切にインストールされ、接続されていることを確認するためのさまざまなチェックを実行できます。また、診断対象のマシンから AMA 関連のログを収集することもできます。

Note

Windows AMA トラブルシューティング ツールは、1.12.0.0 より新しいすべてのバージョンのエージェントに付属するコマンド ライン実行可能ファイルです。

前提条件

トラブルシューティング ツールの存在チェック

診断対象のマシンに AMA エージェント トラブルシューティング ツールのディレクトリが存在するかどうかを確認して、エージェント トラブルシューティング ツールのインストールを確認します。

エージェント トラブルシューティング ツールが存在することを確認するには、次のコマンドをコピーして、PowerShell で管理者として実行します。

Test-Path -Path "C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent"

ディレクトリが存在する場合、Test-Path コマンドレットは True を返します。

PowerShell ウィンドウのスクリーンショット。Test-Path PowerShell コマンドレットの結果が示されています。

ディレクトリが存在しない場合、またはインストールに失敗した場合は、「基本的なトラブルシューティングの手順」に従ってください。

ディレクトリが存在する場合は、 「トラブルシューティング ツールの実行」に進んでください。

トラブルシューティング ツールの実行

診断するマシンで、エージェント トラブルシューティング ツールを実行します。

エージェント トラブルシューティング ツールを開始するには、次のコマンドをコピーして、PowerShell で管理者として実行します。

$currentVersion = ((Get-ChildItem -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows Azure\HandlerState\" `
    | where Name -like "*AzureMonitorWindowsAgent*" `
    | ForEach-Object {$_ | Get-ItemProperty} `
    | where InstallState -eq "Enabled").PSChildName -split('_'))[1]

$troubleshooterPath = "C:\Packages\Plugins\Microsoft.Azure.Monitor.AzureMonitorWindowsAgent\$currentVersion\Troubleshooter"
Set-Location -Path $troubleshooterPath
Start-Process -FilePath $troubleshooterPath\AgentTroubleshooter.exe -ArgumentList "--ama"
Invoke-Item $troubleshooterPath

これにより、完了するまでに最大 15 分かかる可能性がある一連のアクティビティが実行されます。 プロセスが完了するまでお待ちください。

PowerShell ウィンドウのスクリーンショット。AgentTroubleshooter の結果が示されています。

ログ ファイルは、AgentTroubleshooter.exe が配置されているディレクトリに作成されます。

拡張機能ベースのインストールの例: Windows エクスプローラー ウィンドウのスクリーンショット。拡張機能ベースのインストール用の AgentTroubleshooter の出力が示されています。

スタンドアロン インストールの例: Windows エクスプローラー ウィンドウのスクリーンショット。スタンドアロンのインストール用の AgentTroubleshooter の出力が示されています。

よく寄せられる質問

新しいエージェントから以前のエージェントにトラブルシューティング ツールをコピーして、以前のエージェントでそれを実行し、以前のエージェントの問題を診断できますか?

トラブルシューティング ツールを使用して、以前のバージョンのエージェントをコピーして診断することはできません。 トラブルシューティング ツールが正常に動作するには、最新バージョンのエージェントが必要です。

次のステップ