Ausführen des Supportpakettools

Sammeln Sie das Supportpaket für die UiPath Support-Analyse in der Automation Suite auf EKS/AKS.

Das Automation Suite-Supportpakettool sammelt Protokolle auf Anwendungsebene von UiPath®-Diensten und anderen Softwarekomponenten wie Istio und ArgoCD. Das Automation Suite-Supportpakettool enthält auch historische Datensätze, die Sie zur Analyse von Mustern bei der Fehlerbehebung eines Problems verwenden können. Detaillierte 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-Supportpakettool 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-Supportpakettool 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.

Auf hoher Ebene zusammengefasste Verwendungstelemetrie wird auch mit diesem Tool exportiert, das eine XML-Datei generiert. Diese Telemetrie beinhaltet:

• 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 Supportteam zu teilen.

Um die XML-Datei anzuzeigen, öffnen Sie sie mit SQL Server Management Studio oder einem beliebigen XML-Viewer.

Sie können die Generierung dieser zusammengefassten Telemetrie deaktivieren, indem Sie service-metrics in der Ausgeschlossenen Liste in der Automation Suite 2.2510 und höher auflisten.

Generieren des Supportpakets

Führen Sie den folgenden Befehl aus, um das Supportpaket zu generieren:

./uipathctl health bundle input.json --versions versions.json

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

In der folgenden Tabelle sind die optionalen Flags aufgeführt, die das Supportpakettool unterstützt:

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. service-metrics).
--limit-bytes int	Beschränkt die Größe der Protokolle von ausgeführten Pods, indem der Ganzzahlwert in Bytes angegeben wird.

Struktur des Automation Suite-Supportpakets

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

Datei/Ordner	Beschreibung
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.
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.

Hinweis:

Historische Protokolle werden in EKS/AKS-Umgebungen nicht unterstützt.