So verwenden Sie die Azure Monitor Agent-Problembehandlung für das Windows-Betriebssystem (OS)
Die Azure Monitor-Agent-(AMA-)Problembehandlung wurde entwickelt, um Probleme mit dem Agent zu identifizieren und allgemeine Integritätsbewertungen durchzuführen. Es kann verschiedene Prüfungen durchführen, um sicherzustellen, dass der Agent ordnungsgemäß installiert und verbunden ist, und kann auch AMA-bezogene Protokolle vom Computer, der diagnostiziert wird, erfassen.
Hinweis
Die Windows-AMA-Problembehandlung ist eine ausführbare Befehlszeilendatei, die mit dem Agent für alle Versionen ausgeliefert wird, die neuer als 1.12.0.0 sind.
Voraussetzungen
Problembehandlung bei der Existenzprüfung
Überprüfen Sie, ob das Verzeichnis der AMA-Agent-Problembehandlung auf dem Computer vorhanden ist, um die Installation der Agent-Problembehandlung zu bestätigen:
- AMA (Erweiterung): PowerShell
- AMA (Erweiterung): Eingabeaufforderung
- AMA (eigenständig): PowerShell
- AMA (eigenständig): Eingabeaufforderung
Um zu überprüfen, ob die Agent-Problembehandlung vorhanden ist, kopieren Sie den folgenden Befehl und führen Sie ihn in PowerShell als Administrator aus:
Test-Path -Path "C:/Packages/Plugins/Microsoft.Azure.Monitor.AzureMonitorWindowsAgent"
Wenn das Verzeichnis vorhanden ist, gibt das Cmdlet Test-Path True zurück.
Wenn das Verzeichnis nicht vorhanden ist oder die Installation fehlgeschlagen ist, führen Sie die grundlegenden Schritte zur Problembehandlung aus.
Ja, das Verzeichnis ist vorhanden. Fahren Sie mit Ausführen der Problembehandlung fort.
Ausführen der Problembehandlung
Führen Sie auf dem Computer, der diagnostiziert werden soll, die Agent-Problembehandlung aus.
- AMA (Erweiterung): PowerShell
- AMA (Erweiterung): Eingabeaufforderung
- AMA (eigenständig): PowerShell
- AMA (eigenständig): Eingabeaufforderung
Um die Agent-Problembehandlung zu starten, kopieren Sie den folgenden Befehl und führen Sie ihn in PowerShell als Administrator aus:
$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 führt eine Reihe von Aktivitäten aus, die bis zu 15 Minuten dauern können. Warten Sie, bis der Prozess abgeschlossen ist.
Die Protokolldatei wird in dem Verzeichnis erstellt, in dem sich die AgentTroubleshooter.exe befindet.
Beispiel für erweiterungsbasierte Installation: 
Beispiel für eigenständige Installation: 
Häufig gestellte Fragen
Kann ich die Problembehandlung von einem neueren Agent in einen älteren Agent kopieren und auf dem älteren Agent ausführen, um Probleme mit dem älteren Agent zu diagnostizieren?
Es ist nicht möglich, die Problembehandlung zu verwenden, um eine ältere Version des Agents durch Kopieren zu diagnostizieren. Sie müssen über eine aktuelle Version des Agents verfügen, damit die Problembehandlung ordnungsgemäß funktioniert.