Verwenden des Automation Suite-Diagnosetools

Das Automation Suite-Diagnosetool ist die erste Lösung, wenn Probleme mit der Automation Suite auftreten. Es überprüft den Zustand der verschiedenen erforderlichen Komponenten und erstellt einen konsolidierten Bericht.

Tipp:

Laden Sie die ZIP-Datei supportability-tools herunter und extrahieren Sie ihren Inhalt mit den folgenden Befehlen:

curl "https://download.uipath.com/automation-suite/2021.10.3/supportability-tools-2021.10.3.zip" -o supportability-tools-2021.10.3.zip

unzip supportability-tools-2021.10.3.zip -d support-tools

Dann können Sie das Automation Suite-Diagnosetool aus dem Ordner support-tools/diagnostics-tool/ mit dem Befehl bash diagnostics-report.sh ausführen.

In der folgenden Tabelle sind die Überprüfungen aufgeführt, die das Automation Suite-Diagnosetool durchführt. Beachten Sie, dass Sie das Skript auf einem der Knoten im Cluster sowie extern ausführen können.

Knoten	Kontrolliert
Master-Knoten	Prüft, ob die erforderlichen Dienste ausgeführt werden; Prüft, ob die Festplattengrößen richtig konfiguriert sind; Führt einen Kubernetes-Auftrag aus, der Daten über den Zustand anderer Dienste sammelt;
Agenten-Knoten	Prüft, ob die erforderlichen Dienste auf dem Knoten ausgeführt werden Prüft, ob die Festplattengrößen richtig konfiguriert sind;
Externe Maschine	Führt einen Kubernetes-Auftrag aus, um den Zustand der Dienste zu erfassen. Hinweis: Um das Skript von einer externen Maschine aus auszuführen, legen Sie zuerst den richtigen kubeconfig-Kontext auf den Cluster fest und übergeben Sie dann das Flag -e an das Skript bash diagnostics-report.sh -e.

Beispielbericht, der vom Automation Suite-Diagnosetool generiert wurde.

Lesen von Diagnoseberichten

INFO-Protokolle

INFO-Protokolle in Grün zeigen, dass die erforderlichen Prüfungen bestanden wurden. Sie sollten jedoch die Festplatten-/Speichernutzung weiterhin gründlich kontrollieren, um verborgene Fehler zu vermeiden.

WARN-Meldungen

Obwohl diese Meldungen kein hohes Risiko bedeuten, müssen Sie die Fehler möglicherweise korrigieren, da sie sich in bestimmten Fällen auf einige Dienste auswirken könnten.

Fehlermeldungen

Sie müssen die von diesen Nachrichten beschriebenen Probleme beheben, da sie sich auf einen Dienst im Cluster auswirken.

Rke2-Server oder Rke2-Agent-Dienst ausgefallen

Wenn diese Dienste ausgefallen sind, bedeutet dies, dass der Knoten ausgefallen ist. Versuchen Sie, den Dienst mithilfe des systemctl-Neustarts <service-name> neu zu starten. Dadurch sollte das Problem behoben werden.

Bereitgestellte Verzeichnisgröße unter /var/lib

Der Bericht zeigt die Größe des Verzeichnisses an, das unter /var/lib bereitgestellt wird, da Kubernetes es zum Speichern ihrer Daten verwendet. Wenn das Verzeichnis voll ist, können verschiedene Probleme auftreten. Um diese Probleme zu vermeiden, vergrößern Sie es entsprechend.

Rke2-Version

Der Bericht zeigt die Version rke2 an.

Festplattendruck oder Speicherdruck

Bei allen Knoten geben wir an, ob Festplattendruck oder Speicherdruck vorliegt. Ist das der Fall, können bei Workloads auf diesen Knoten Probleme auftreten. Überprüfen Sie, ob auf diesen Knoten andere Prozesse ausgeführt werden, die Ressourcen verbrauchen, und entfernen Sie sie gegebenenfalls.

Status der Ceph-Dienste

Wir verwenden Ceph als S3-Objektspeicher zum Speichern von Protokollen und Dateien aus verschiedenen Anwendungen. Sie können den Status der Dienste sehen. Falls sie ausgefallen sind, müssen Sie sie möglicherweise neu starten. Überprüfen Sie auch, ob die Festplattennutzung durch Ceph ausgereizt ist.

Ports 443 und 31443

Wir erwarten, dass Ports 443 und 31443 mit dem angegebenen Hostnamen offen sind. Der Bericht zeigt an, wenn sie nicht zugänglich sind. Stellen Sie sicher, dass Sie die entsprechenden Ports öffnen, falls dieser Hinweis kommt.

Gültigkeit des Zertifikats

Das Tool prüft, ob das hochgeladene Zertifikat für den angegebenen Hostnamen gültig ist und ob es noch nicht abgelaufen ist. Wenn das Zertifikat diese Kriterien nicht erfüllt, treten Fehler auf. Um dies zu verhindern, überprüfen Sie Ihr hochgeladenes Zertifikat und ändern Sie es bei Bedarf.

GPU

Da für einige Dienste erforderlich ist, dass auf einigen Knoten im Cluster eine GPU vorhanden ist, prüft das Automation Suite-Diagnosetool, ob GPU-Knoten vorhanden sind, und gibt die Anzahl dieser Knoten aus. Wenn Sie wissen, dass GPU-Knoten vorhanden sind, diese aber hier nicht angezeigt werden, bedeutet das, dass bei der GPU-Einrichtung ein Fehler aufgetreten ist.

MongoDB

MongoDB ist eine wichtige Komponente, die der Dienst UiPath Apps verwendet. Wenn MongoDB oder seine primäre Instanz ausgefallen ist, müssen Sie das Problem mithilfe des Supportpakets untersuchen.

RabbitMQ und DockerRegistry

RabbitMQ und DockerRegistry sind zwei wichtige Komponenten, die von einigen Diensten genutzt werden. Ist einer von ihnen ausgefallen, müssen Sie das Problem untersuchen und einen Neustart durchführen.

ArgoCD ausgefallen

Die ArgoCD ist unser Tool für das Application Lifecycle Management (ALM). Wenn einer seiner Dienste ausgefallen ist, kann das daran liegen, dass andere Anwendungen veraltet sind oder andere Probleme haben. Die Wiederherstellung dieser Dienste ist wichtig und erfordert möglicherweise weitere Fehlerbehebungen.

Fehlende oder mangelhafte ArgoCD-Anwendungen

Das Automation Suite-Diagnosetool zeigt an, ob ArgoCD-Anwendungen fehlen und beeinträchtigt sind.

• Wenn Anwendungen fehlen, wechseln Sie zur ArgoCD-Benutzeroberfläche und synchronisieren Sie sie.
• Wenn Anwendungen mangelhaft laufen, sind zusätzliche Fehlerbehebungen erforderlich, um die von der ArgoCD ausgelösten Fehler zu untersuchen.