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.

Parameter des Automation Suite-Supportpakettools

• Auf hoher Ebene zusammengefasste Nutzungs- und Konfigurationstelemetrie wird mit diesem Tool ebenfalls exportiert, das eine XML-Datei generiert. Diese Telemetrie umfasst:
  • Konfigurationsdetails der Automation Suite-Installation (z. B. Kubernetes-Variante, Installationsmodus, Version und aktivierte Dienste neben anderen Einstellungen).
  • Informationen zur Ressourcennutzung auf Clusterebene (z. B. CPU- und Speicherverfügbarkeit und -nutzung neben anderen Metriken).
  • Details zur UiPathctl-Befehlsausführung (z. B. Status, Protokolle und Dauer).
  • Nutzungstelemetrie:
    • Roboterausführungsdauer pro Monat nach Robotertyp.
    • Roboter-Gleichzeitigkeit – die maximale Anzahl von Robotern, die gleichzeitig ausgeführt wurden.
    • Metriken für ausgeführte Aufträge, ausgeführte Prozesse, Warteschlangenelemente, Auftragsfehlerquote und Benutzer.
    • Umgebungsinformationen.
    • Zusammenfassung der AI Units-Nutzung, wenn Sie das AI Center verwenden.
• UiPath verwendet diese Daten nur für interne Berichte, um das Kundenverständnis zu stärken und die Qualität des Supports und der Gesamterfahrung zu verbessern.
• Sie können die XML-Datei im Customer Portal hochladen, um Ihre selbst gehostete Nutzungstelemetrie auf hoher Ebene mit dem UiPath Support-Team zu teilen.
• Sie können das Generieren einer zusammengefassten Telemetrie beenden, indem Sie service-metrics zur Ausschlussliste mit der Option --exclude=service-metrics hinzufügen. Diese Option ist in der Automation Suite 2.2510 und höher verfügbar.

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

Ab Automation Suite 2.2510.1 sind die Pfade zur Konfigurationsdatei (cluster_config.json) und zur Versionsdatei (helm-charts.json) optional. Sie können das Supportpaket einfach generieren, indem Sie Folgendes ausführen:

./bin/uipathctl health bundle

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.
--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 oder --exclude=service-metrics).
--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.
service-metrics	Enthält Konfigurations- und Nutzungstelemetrie auf hoher Ebene, die in einzelnen XML-Dateien gespeichert sind.

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.