Windows オペレーティング システム (OS) の Azure Monitor エージェント トラブルシューティング ツールの使用方法
Azure Monitor エージェント (AMA) トラブルシューティング ツールは、エージェントに関する問題を特定し、一般的な正常性評価を実行する際に役立つように設計されています。 これは、エージェントが適切にインストールされ、接続されていることを確認するためのさまざまなチェックを実行できます。また、診断対象のマシンから AMA 関連のログを収集することもできます。
Note
Windows AMA トラブルシューティング ツールは、1.12.0.0 より新しいすべてのバージョンのエージェントに付属するコマンド ライン実行可能ファイルです。
前提条件
トラブルシューティング ツールの存在チェック
診断対象のマシンに AMA エージェント トラブルシューティング ツールのディレクトリが存在するかどうかを確認して、エージェント トラブルシューティング ツールのインストールを確認します:
C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent
エージェント トラブルシューティング ツールが存在することを確認するには、次のコマンドをコピーして、PowerShell で管理者として実行します。
Test-Path -Path "C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent"
ディレクトリが存在する場合、Test-Path コマンドレットは True を返します。
ディレクトリが存在しない場合、またはインストールに失敗した場合は、「基本的なトラブルシューティングの手順」に従ってください。
ディレクトリが存在する場合は、 「トラブルシューティング ツールの実行」に進んでください。
トラブルシューティング ツールの実行
診断するマシンで、エージェント トラブルシューティング ツールを実行します。
エージェント トラブルシューティング ツールを開始するには、次のコマンドをコピーして、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 分かかる可能性がある一連のアクティビティが実行されます。 プロセスが完了するまでお待ちください。
ログ ファイルは、AgentTroubleshooter.exe が配置されているディレクトリに作成されます。
よく寄せられる質問
新しいエージェントから以前のエージェントにトラブルシューティング ツールをコピーして、以前のエージェントでそれを実行し、以前のエージェントの問題を診断できますか?
トラブルシューティング ツールを使用して、コピーすることにより以前のバージョンのエージェントを診断することはできません。 トラブルシューティング ツールが正常に動作するには、最新バージョンのエージェントが必要になります。