Verwenden des Automation Suite-Supportpakets

Überblick

Hinweis:

Sie können das Automation Suite Support Bundle-Tool wie folgt abrufen:

• Durch Entpacken des Installationspakets „as-installer.zip“
• Durch Herunterladen von supportability-tools.zip

Bevor Sie das Automation Suite-Supportpaket-Tool ausführen, navigieren Sie zum Installationsordner. Sie finden das Installationsprogramm am folgenden Speicherort oder dort, wo Sie es heruntergeladen haben:

cd /opt/UiPathAutomationSuite/{version}/installer

Führen Sie die folgenden Befehle aus, um das Automation Suite Supportpaket-Tool zu verwenden:

cd ./Support-Tools/support-bundle
./support-bundle.sh

Hinweis: Stellen Sie in Azure sicher, dass Ihre IP zur Netzwerksicherheitsgruppe hinzugefügt wird.

Die folgende Abbildung zeigt eine typische Ausgabe für diesen Befehl:

Parameter des Automation Suite-Supportpakettools

• Wenn Sie nur bash support-bundle.sh ausführen, werden Protokolle der letzten 2 Tage aus dem S3-kompatiblen Objektspeicher gesammelt, wenn Sie einen externen Objektspeicher verwenden, oder von Ceph, wenn Sie den clusterinternen Objektspeicher verwenden.
• Um das Startdatum für den Protokollerfassungsprozess festzulegen, verwenden Sie das Argument -F und geben Sie das Datum im Format YYYY-MM-DD ein. Um die Anzahl der Tage festzulegen, für die Sie Protokolle sammeln möchten, berechnet ab dem Startdatum, verwenden Sie das Argument -D und geben Sie die Anzahl der Tage als Integer ein. Um beispielsweise Protokolle für das Intervall zwischen dem 20. Juli 2024 und dem 24. Juli 2024 zu sammeln, führen Sie bash support-bundle.sh -F 2024-07-20 -D 5 aus.
  Um Protokolle für ein bestimmtes Datum zu sammeln, verwenden Sie das Argument -F , um das Datum anzugeben, und das Argument -D , um ein Intervall von einem Tag festzulegen. Um beispielsweise Protokolle für den 20. Juli 2024 zu sammeln, führen Sie bash support-bundle.sh -F 2024-07-20 -D 1 aus.
  Wenn Sie die Anzahl der Tage, für die Sie Protokolle sammeln möchten, nicht festlegen, verwendet das Tool ein Standardintervall von 7 Tagen, gerechnet ab dem Startdatum. Wenn Sie beispielsweise bash support-bundle.sh -F 2024-07-20 ausführen, werden Protokolle für das Intervall zwischen dem 20. Juli 2024 und dem 26. Juli 2024 gesammelt.
• Wir erfassen Protokolle für fast alle Namespaces, die in der Automation Suite verwendet werden. Um Protokolle nur für bestimmte Namespaces zu erfassen, führen Sie bash support-bundle.sh -N uipath,uipath-infra aus. Verwenden Sie -N als Liste von Namespaces, für die Sie die Protokolle sammeln möchten.
• Die RKE2-, UiPath-, Redis- und Longhorn-Pakete werden standardmäßig generiert.
  • Um das RKE2-Paket zu deaktivieren, führen Sie den Befehl support-bundle.sh -e aus.
  • Befehle mit langer Ausführungszeit im RKE-Paket sind deaktiviert. Um sie zu aktivieren, führen Sie den Befehl scripts/rke2-support-bundle.sh -a aus.
  • Um die Generierung von Redis-Bundles zu deaktivieren, führen Sie den Befehl support-bundle.sh -s aus.
• Auf hoher Ebene zusammengefasste Verwendungstelemetrie wird auch mit diesem Tool exportiert, das eine XML-Datei generiert. Diese Telemetrie beinhaltet:
  • 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.
• 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 die Generierung dieser zusammengefassten Telemetrie deaktivieren, indem Sie -c in den RKE-Umgebungen für die Automation Suite 2023.10 und niedriger verwenden.

Struktur des Automation Suite-Supportpakets

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

Datei/Ordner	Beschreibung
logs	Enthält Protokolle, die aus dem S3-Speicher gesammelt wurden.
events	Enthält Ereignisbeschreibungen aus allen Namespaces.
nodes.info	Enthält Beschreibungen aller Knoten im Cluster.
jobs/deployments/pods/daemonsets	Enthält Beschreibungen entsprechender Objekte aus allen Namespaces.
current-logs	Enthält Protokolle der letzten 4 Stunden von aktuell ausgeführten Pods. Wir sammeln dies für den Fall, dass der Ceph-S3-Speicher ausfällt.
service-metrics	Enthält Nutzungstelemetrie auf hoher Ebene, die in einzelnen XML-Dateien gespeichert ist.

Wenn dem Befehl eine bestimmte Namespaceliste übergeben wurde, sieht die Struktur wie in der folgenden Abbildung aus:

Erkunden von Protokollen

Da wir einen öffentlich herunterladbaren Link zum Supportpakettool zur Automation Suite zur Verfügung stellen, können Sie es auf jede Maschine herunterladen und in jedem Editor öffnen und verwenden, z. B. VS Code.

Um die Protokolle der letzten 30 Tage abzurufen, führen Sie support-bundle.sh -F 2023-09-18 -D 30 aus.