Probleemoplosser voor Azure Monitor Agent voor Windows-besturingssysteem (OS) gebruiken

De probleemoplosser voor de Azure Monitor-agent (AMA) is ontworpen om problemen met de agent te identificeren en algemene statusbeoordelingen uit te voeren. Deze kan verschillende controles uitvoeren om te controleren of de agent correct is geïnstalleerd en verbonden, en kan ook AMA-gerelateerde logboeken verzamelen van de machine waar een diagnose voor moet worden gesteld.

Notitie

De Probleemoplosser voor Windows AMA is een uitvoerbaar opdrachtregelprogramma dat wordt geleverd met de agent voor alle versies hoger dan 1.12.0.0.

Vereisten

Aanwezigheidscontrole van probleemoplosser

Controleer of de map probleemoplosser voor AMA-agents op de computer aanwezig is om de installatie van de probleemoplosser voor agents te bevestigen:

AMA-extensie - PowerShell

Als u wilt controleren of de probleemoplosser voor agents aanwezig is, kopieert u de volgende opdracht en voert u deze uit in PowerShell als beheerder:

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

Als de map bestaat, retourneert Truede cmdlet Test-Path.

AMA-extensie - opdrachtprompt

Als u wilt controleren of de probleemoplosser voor agents aanwezig is, kopieert u de volgende opdracht en voert u deze uit in de opdrachtprompt als beheerder:

cd "C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent"

Als de map bestaat, worden de mappen met de cd-opdracht gewijzigd.

AMA Standalone - PowerShell

Als u wilt controleren of de probleemoplosser voor agents aanwezig is, kopieert u de volgende opdracht en voert u deze uit in PowerShell als beheerder:

$installPath = (Get-ItemProperty -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMonitorAgent").AMAInstallPath
Test-Path -Path $installPath\Troubleshooter

Als de map bestaat, retourneert Truede cmdlet Test-Path.

Zelfstandige AMA - opdrachtprompt

Als u wilt controleren of de probleemoplosser voor agents aanwezig is, kopieert u de volgende opdracht en voert u deze uit in de opdrachtprompt als beheerder:

Notitie

Als u het AMAInstallPath hebt aangepast, moet u het onderstaande pad aanpassen aan uw aangepaste pad.

cd "C:\Program Files\Azure Monitor Agent\Troubleshooter"

Als de map bestaat, worden de mappen met de cd-opdracht gewijzigd.

Als de map niet bestaat of de installatie is mislukt, volgt u de basisstappen voor probleemoplossing.

Ja, de map bestaat. Ga verder met het uitvoeren van de probleemoplosser.

De probleemoplosser uitvoeren

Voer de probleemoplosser voor agents uit op de computer die moet worden opgegeven.

AMA-extensie - PowerShell

Als u de probleemoplosser voor agents wilt starten, kopieert u de volgende opdracht en voert u deze uit als beheerder in 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

Er wordt een reeks activiteiten uitgevoerd die tot 15 minuten kunnen duren. Wees geduldig totdat het proces is voltooid.

AMA-extensie - opdrachtprompt

Als u de probleemoplosser voor agents wilt starten, kopieert u de volgende opdracht en voert u de opdrachtprompt uit als beheerder:

Notitie

Opmerking: u moet de {version} bijwerken zodat deze overeenkomt met het geïnstalleerde versienummer. In het volgende voorbeeld is de versie 1.20.0.0.

cd C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent/{version}/Troubleshooter/
AgentTroubleshooter.exe --ama

Er wordt een reeks activiteiten uitgevoerd die tot 15 minuten kunnen duren. Wees geduldig totdat dit proces is voltooid.

AMA Standalone - PowerShell

Als u de probleemoplosser voor agents wilt starten, kopieert u de volgende opdracht en voert u deze uit als beheerder in PowerShell:

$installPath = (Get-ItemProperty -Path "Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\AzureMonitorAgent").AMAInstallPath
Set-Location -Path $installPath\Troubleshooter
Start-Process -FilePath $installPath\Troubleshooter\AgentTroubleshooter.exe -ArgumentList "--ama"
Invoke-Item $installPath\Troubleshooter

Er wordt een reeks activiteiten uitgevoerd die tot 15 minuten kunnen duren. Wees geduldig totdat het proces is voltooid.

Zelfstandige AMA - opdrachtprompt

Als u de probleemoplosser voor agents wilt starten, kopieert u de volgende opdracht en voert u de opdrachtprompt uit als beheerder:

Notitie

Als u het AMAInstallPath hebt aangepast, moet u het onderstaande pad aanpassen aan uw aangepaste pad.

cd "C:\Program Files\Azure Monitor Agent\Troubleshooter"
AgentTroubleshooter.exe --ama

Er wordt een reeks activiteiten uitgevoerd die tot 15 minuten kunnen duren. Wees geduldig totdat dit proces is voltooid.

Het logboekbestand wordt gemaakt in de map waarin de AgentTroubleshooter.exe zich bevindt.

Voorbeeld voor installatie op basis van extensies:

Voorbeeld voor zelfstandige installatie:

Veelgestelde vragen

Kan ik de probleemoplosser van een nieuwere agent kopiëren naar een oudere agent en deze uitvoeren op de oudere agent om problemen met de oudere agent vast te stellen?

Het is niet mogelijk om de probleemoplosser te gebruiken om een oudere versie van de agent te diagnosticeren door deze te kopiëren. U moet een bijgewerkte versie van de agent hebben om de probleemoplosser goed te laten werken.

Volgende stappen

• Richtlijnen voor probleemoplossing voor de Azure Monitor-agent op virtuele Windows-machines en schaalsets
• Richtlijnen voor probleemoplossing voor de Azure Monitor-agent op Windows Arc-server