Freigeben über


So verwenden Sie den Azure Monitor Agent Troubleshooter für das Linux-Betriebssystem (OS)

Achtung

Dieser Artikel bezieht sich auf CentOS, eine Linux-Distribution, deren Dienstende (End-of-Life, EOL) ansteht. Sie sollten Ihre Nutzung entsprechend planen. Weitere Informationen finden Sie im CentOS End-of-Life-Leitfaden.

Die Problembehandlung für den Azure Monitor-Agent (AMA) 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 AMA-Problembehandlung ist eine ausführbare Datei, die mit dem Agenten für alle Versionen neuer als 1.25.1 für Linux mitgeliefert wird.

Voraussetzungen

Python-Anforderung

Für die Linux-AMA-Problembehandlung ist Python 2.6+ oder eine auf dem Computer installierte Python 3-Version erforderlich.

Um zu überprüfen, ob Python auf Ihrem Computer installiert ist, kopieren Sie den folgenden Befehl, und führen Sie den Befehl in Bash als Stamm aus:

sudo python -V
sudo python3 -V

Screenshot: Befehle zum Überprüfen der Python-Version in Linux

Mehrere Python-Versionen können installiert und aliasiert werden. Wenn mehrere Versionen installiert sind, verwenden Sie:

ls -ls /usr/bin/python*

Screenshot: Befehl zum Überprüfen mehrerer Python-Versionen für Linux

Wenn Ihr virtueller Computer eine Distribution verwendet, in der Python 3 nicht standardmäßig enthalten ist, müssen Sie die Sprache installieren. Mithilfe der folgenden Beispielbefehle wird Python 3 auf verschiedenen Distributionen installiert:

sudo yum install -y python3

Darüber hinaus müssen die folgenden Python-Pakete ausgeführt werden (alle sollten bei einer Standardinstallation von Python2 oder Python3 vorhanden sein):

Python-Paket Erforderlich für Python 2? Erforderlich für Python 3?
kopieren ja ja
Datum/Uhrzeit ja ja
json ja ja
os ja ja
Plattform ja ja
re ja ja
requests nein ja
shutil ja ja
Unterprozess ja ja
url lib ja nein
xml.dom.minidom ja ja

Problembehandlung bei der Existenzprüfung

Überprüfen Sie, ob das Verzeichnis der AMA-Agent-Problembehandlung auf dem zu diagnostizierenden Computer vorhanden ist, um die Installation der Agent-Problembehandlung zu bestätigen:

/var/lib/waagent/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-{version}

Um zu überprüfen, ob die Azure Monitor-Agent-Problembehandlung vorhanden ist, kopieren Sie den folgenden Befehl und führen Sie ihn in Bash als Root aus:

ls -ltr /var/lib/waagent | grep "Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-*"

Screenshot: Bash-Fenster mit dem Ergebnis des ls-Befehls für das AMA-Installationsverzeichnis

Wenn das Verzeichnis nicht vorhanden ist oder die Installation fehlgeschlagen ist, führen Sie die grundlegenden Schritte zur Problembehandlung aus.

Wenn das Verzeichnis vorhanden ist, fahren Sie mit Problembehandlung ausführen fort.

Ausführen der Problembehandlung

Führen Sie auf dem zu diagnostizierenden Computer die Agent-Problembehandlung aus.

Der Protokollmodus ermöglicht die Sammlung von Protokollen, die dann zum Exportieren oder Überprüfen in das TGZ-Format komprimiert werden können. Im interaktiven Modus können Benutzer aktiv an Problembehandlungsszenarien teilnehmen und die Ausgabe direkt in der Shell anzeigen.

Um den Agent-Troubleshooter im Log-Modus zu starten, kopieren Sie den folgenden Befehl und führen Sie ihn in Bash als Root-Benutzer aus.

Hinweis

Sie müssen die {Version} entsprechend Ihrer installierten Versionsnummer aktualisieren. Im folgenden Beispiel ist die Version 1.28.11.

cd /var/lib/waagent/Microsoft.Azure.Monitor.AzureMonitorLinuxAgent-{version}/ama_tst/
sudo sh ama_troubleshooter.sh -L

Geben Sie einen Pfad ein, auf dem Protokolle ausgegeben werden sollen. Sie können z. B. /tmpverwenden.

Es führt eine Reihe von Vorgängen aus und gibt eine .tgz-Datei in das von Ihnen angegebene Ausgabeverzeichnis aus. Seien Sie geduldet, bis dieser Prozess abgeschlossen ist.

Screenshot: Bash-Fenster mit dem Ergebnis der Ausführung von AgentTroubleshooter mit der Option „-L“ zum Generieren von Protokollen

Häufig gestellte Fragen

Kann ich die Problembehandlung von einem neueren Agenten auf einen älteren Agenten kopieren und auf dem älteren Agenten ausführen, um Probleme mit dem älteren Agenten 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.

Nächste Schritte