Verwenden des Automation Suite-Supportpakets

Überblick

Das Automation Suite-Supportpaket sammelt Protokolle auf Anwendungsebene von UiPath®-Diensten und relevanten Objekten, die zum Auswerten und Beheben des Problems erforderlich sind. Das Automation Suite-Supportpaket enthält auch historische Protokolle, die Sie zur Analyse von Mustern bei der Fehlerbehebung eines Problems verwenden können. Historische Protokolle sind besonders hilfreich, wenn die potenzielle Ursache eines Problems nicht allein durch einen Blick auf den Status des Clusters erkennbar ist.

Das Automation Suite-Supportpaket ist auch erforderlich, wenn Sie eine Anleitung oder Fehlerbehebung vom UiPath®-Supportteam anfordern, da es dieses für Analysezwecke benötigt.

Hinweis:

Das Automation Suite-Supportpaket sammelt oder speichert keine personenbezogenen oder vertraulichen Daten von Ihnen, Ihrem Benutzer oder Ihrer Automatisierung. UiPath®-Anwendungen legen keine vertraulichen Informationen offen und protokollieren diese auch nicht in Datensätzen. Auf Plattformebene ist die Protokollsammlung so konzipiert, dass solche kritischen Informationen unkenntlich gemacht werden.

Generieren des Supportpakets

Um das Supportpaket zu generieren, führen Sie den folgenden Befehl im Installationsverzeichnis aus:

./bin/uipathctl health bundle cluster_config.json --versions versions/helm-charts.json

Dieses Tool benötigt einige Zeit, um alle Protokolle an einem temporären Ort auf Ihrer lokalen Maschine oder Verwaltungsmaschine zu sammeln und zu speichern.

In der folgenden Tabelle sind die optionalen Flags aufgeführt, die Sie für das Supportpakettool verwenden können:

Flaggen	Beschreibung
--output-dir string	Geben Sie das Verzeichnis an, in dem das Supportpaket gespeichert werden soll.
--skip-diagnose	Boolesches Flag zum Überspringen des Diagnoseberichts. Standardmäßig enthält das Paket die Diagnoseberichte. Sie können dieses Flag verwenden, um den Diagnosebericht vom Supportpaket auszuschließen.
--namespace string	Geben Sie den Namespace an, in dem die UiPath Automation Suite bereitgestellt wird.
--include string	Geben Sie zusätzliche Komponenten (durch Kommas getrennt) an, die in das Paket aufgenommen werden sollen (z. B. --include=historical-logs).
--exclude string	Geben Sie Komponenten (durch Kommas getrennt) an, die vom Paket ausgeschlossen werden sollen (z. B. --exclude=rke2-bundle).
--from YYYY-MM-DD	Das Startdatum zum Sammeln der historischen Protokolle im Format JJJJ-MM-TT.
--days int	Die Anzahl der Tage ab dem Startdatum, für die die historischen Protokolle gesammelt werden sollen.
--limit-bytes int	Beschränkt die Größe der Protokolle von ausgeführten Pods, indem der Ganzzahlwert in Bytes angegeben wird.

Wenn das Flag --from nicht angegeben ist, werden standardmäßig die historischen Protokolle für die letzten 2 Tage ab heute gesammelt, unabhängig vom angegebenen --days . Wenn --from angegeben ist und --days nicht, dann werden die historischen Protokolle für 2 Tage ab dem angegebenen Startdatum gesammelt.

Das RKE2-Paket ist standardmäßig im Supportpaket enthalten. Um sie auszuschließen, verwenden Sieflag --exclude=rke2-bundle.

Die historischen Protokolle sind standardmäßig nicht im Supportpaket enthalten. Um sie einzuschließen, verwenden Sie das Flag --include=historical-logs.

Struktur des Automation Suite-Supportpakets

Das .tar.gz-Archiv enthält folgende Dateien und Ordner:

Datei/Ordner	Beschreibung
logs	Enthält die historischen Protokolle, die von ceph oder einem externen Objektspeicher gesammelt wurden.
current-logs	Enthält die Live-Protokolle (z. B. Protokolle für die aktuelle und vorherige Pod-Instanz).
events.json	Enthält die Ereignisbeschreibungen aus allen Namespaces.
alerts	Enthält die aktiven Prometheus-Warnungen im Cluster.
server0.tar.gz, server1.tar.gz, ...	Enthält das RKE2-Paket für jeden Knoten im Cluster.
namespace/resource/object.yaml	Enthält die Objektbeschreibungen für den serverbevorzugten/benutzerdefinierten Namespace und die clusterbezogenen Ressourcen.

Die RKE2-Paketstruktur ist wie folgt:

Verzeichnis (Directory)	Beschreibung
systemlogs	Enthält die Protokolle im Zusammenhang mit Systemereignissen, Sicherheitsprüfungen und allgemeinen Systemmeldungen.
systeminfo	Enthält Informationen zu ausgeführten Prozessen, Datenträgernutzung, CPU-Auslastung usw.
etcd	Enthält die Informationen zur Datenspeicherung des Schlüssel-Wert-Speichers etcd .
journald	Enthält die von systemd-journald verwalteten Protokolle.
networking	Enthält die Netzwerkkonfigurationsdetails wie iptables, Routing usw.
rke2	Enthält die Kubelet-Protokolle, Agent- und Serverzertifikate, Informationen zu kritisch und den im Cluster ausgeführten Ressourcen sowie die Pod-Protokolle.