Über das Diagnose-Tool

Das UiPath-Diagnosetool ist ein eigenständiges Dienstprogramm, mit dem Sie Diagnoseinformationen besser erfassen und in der Vorschau anzeigen können, die dann verpackt und an unser technisches Support-Team gesendet werden können, um Ihnen bei der Lösung potenzieller Probleme zu helfen.

Es enthält eine Vielzahl integrierter Sammler, mit denen Sie genau die benötigten Daten erfassen. Darüber hinaus können Sie ausgewählte Sammler zu weiteren Verwendung als Profil speichern. Informationen können von Studio, Robot, RobotJS, Aktivitäten und Orchestrator gesammelt werden.

Sie können das Diagnosetool aus dem Ressourcencenter in Ihrer Automation Cloud-Instanz herunterladen.

Es wird auch mit Studio installiert, und Sie finden es im Ordner C:\Program Files\UiPath\Studio (für Installationen pro Maschine) oder im Ordner %localappdata%\Programs\UiPath\Studio (für Installationen pro Benutzer).

Um darauf zuzugreifen, klicken Sie einfach auf die Schaltfläche Start und suchen Sie nach der Anwendung „Diagnosetool“.

Der Abschnitt „Start“

Das Diagnose-Tool basiert auf Profilen, die Informationen mithilfe von Sammlern sammeln. Ein Profil ist eine Gruppe von Sammlern, die auf das Sammeln bestimmter Informationen spezialisiert sind, je nach Ihren Prolemen. Das Tool verfügt über ein paar vordefinierte Profile, jedes mit einem bestimmten Satz von Sammlern. Sie können aber auch Ihre eigenen Profile erstellen, jedes für ein bestimmtes Problem. Auch wenn Sie mit einem vordefinierten Profil beginnen, können Sie später Sammler hinzufügen oder entfernen, je nachdem, welche Informationen gesammelt werden müssen.

Profil	Beschreibung
Problem mit Studio/Roboter/Aktivitäten	Sammelt Informationen zu Studio, Roboter oder Aktivitäten. Dieses Profil enthält standardmäßig mehrere aktivierte Sammler.
Orchestrator-Problem	Sammelt Informationen über Ihre Verbindung zu Orchestrator. Dieses Profil enthält standardmäßig mehrere aktivierte Sammler.
Leeres Profil	Dieses Profil enthält keine ausgewählten Sammler. Hier können Sie benutzerdefinierte Profile mit den gewünschten Sammlern erstellen, die Sie später verwenden können.
Benutzerdefinierter Standort	Sammelt Informationen basierend auf einer .json-Datei, die Sie bereitstellen. Sie können die zu verwendenden Sammler auswählen.

Darüber hinaus können Sie ein zuvor generiertes .zip-Paket gesammelter Daten importieren, das überprüft werden soll.

Der Abschnitt „Konfigurieren“

In diesem Abschnitt befinden sich alle Sammler. In den ersten beiden Profilen wurden bereits mehrere Sammler hinzugefügt, aber Sie können auch andere hinzufügen oder vorhandene entfernen. Verfügbare Sammler:

Sammler	Gesammelte Informationen
Registrierungsinformationen	Verwendete Registrierungsschlüssel sowie der entsprechende Wertname und die entsprechenden Wertdaten.
Bildschirminformationen	Verwendete Anzeige oder Anzeigen sowie Typ-, Auflösungs-, DPI- und Offsetkoordinaten.
Ereignisprotokolle	Generiert eine .evtx-Protokolldatei für die ausgewählte Anwendung. Dieser Sammler kann mit den folgenden Filtern verwendet werden: • Zeitraum (Anzahl der Tage) • Ereignisebene • Quellenfilter (durch Kommas getrennte Liste der Anwendungsquellen)
Umgebungsvariablen	Verwendete System- oder lokale Umgebungsvariablen, basierend auf einer konfigurierbaren Klausel.
Computerinformationen	Name, Domäne, Betriebssystem, Sitzung, Administrator und Proxyeinstellungen des Computers.
Protokolldateien	Ausführungs-, Studio-, ETL- und kombinierte Protokolle. Sie können aus jedem Abschnitt angezeigt und exportiert werden.
Prozessinformationen	Verwendete Systemprozesse.
Drittparteien-Installationen	Listet alle verwendeten Anwendungen von Drittanbietern auf.
UiPath wird installiert.	Listet alle installierten UiPath-Produkte auf diesem Computer sowie Version, Typ und Pfad auf.
Lizenz	Zeigt den Lizenztyp und den Status an.
Datei Einstellungen (Settings)	Listet die verfügbaren UiPath.settings-, UiStudio.settings-, UiStudio.v2.settings- und NuGet.config-Dateien mit der Möglichkeit auf, darauf zuzugreifen.
Orchestrator-Webkonfiguration	Zeigt die Web.config-Datei basierend auf dem angegebenen Speicherort des Registrierungsschlüssels und seinem Wert an.
Hostdatei der Orchestrator-Anwendung	Zeigt die applicationhost.config-Datei basierend auf einem angegebenen Ordner an.
Dateien	Ruft die Dateien von einem angegebenen DirectoryPath mit einem konfigurierbaren Pattern ab.
Benutzerdefinierte Registrierung	Ruft die verwendeten Registrierungsschlüssel sowie den entsprechenden Wertnamen und Wertdaten aus einem benutzerdefinierten Pfad ab.

Wenn Sie mit den bereitgestellten Sammlern eines Profils nicht zufrieden sind, können Sie diese einfach entfernen, indem Sie auf die Schaltfläche x im entsprechenden Sammlercontainer klicken.

Wenn Sie das Gefühl haben, dass Sie mehr Sammler benötigen, klicken Sie auf die Schaltfläche Neuen Sammler hinzufügen, und wählen Sie den benötigten aus der Liste aus.

Wenn Sie einige Sammler mehrmals verwenden möchten, können Sie sie der Liste hinzufügen und auf die Schaltfläche Profil in Datei exportieren klicken. Dadurch wird eine .json-Datei generiert, die Sie später aus dem Abschnitt Start importieren können.

Einige Sammler ermöglichen es Ihnen, Informationen detaillierter anzuzeigen.

Mit dem Sammler Protokolldateien können Sie beispielsweise gesammelte Dateien eines Protokolltyps (ExecutionLogs, StudioLogs, EtlLogsoder CombinedLogs) in einem separaten Fenster untersuchen, mit der Möglichkeit, den Pfad einer Protokolldatei anzuzeigen, zu öffnen oder sogar auszuwählen, welche der Protokolldateien exportiert werden soll.

Auf ähnliche Weise zeigt der Sammler Registrierungsinformationen nur die ersten Ergebnisse im Abschnitt Vorschau an, ermöglicht es Ihnen jedoch, alle Ergebnisse in einem separaten Fenster anzuzeigen, indem Sie auf die Schaltfläche x von y werden angezeigt klicken. Dabei ist x die angezeigte Anzahl von Ergebnissen und y die Gesamtzahl.

Der Abschnitt „Vorschau“

Hier werden alle gesammelten Informationen angezeigt. Sie sind in reduzierbaren Feldern gruppiert, um Informationen leicht lesbar zu machen. Wenn Sie mit bestimmten Sammlern nicht zufrieden sind, können Sie sie einfach deaktivieren, damit sie nicht in das endgültige Paket exportiert werden.

Sammler, die Sie für den Export nicht für notwendig erachten, können hier deaktiviert werden. Deaktivieren Sie einfach die gewünschten Sammler, bevor Sie auf Weiter klicken.

Der Abschnitt „Exportieren“

Der letzte Abschnitt zeigt eine Vorschau der im Prozess verwendeten Sammler. Sie müssen jetzt nur noch auf Exportieren klicke, um alle gesammelten Daten in einem .zip-Paket zu speichern, mit der Möglichkeit, den Speicherort zu öffnen, in dem die Datei gespeichert wird. Sie können auch zwischen den Abschnitten navigieren, wenn Sie Änderungen an Sammlern vornehmen möchten.

Kommandozeilenargumente

Das Diagnosetool kann auch über die Eingabeaufforderung oder Windows PowerShell verwendet werden. Die Argumente und ihre Ergebnisse sind unabhängig vom Verwendungsmodus identisch.

Kann wie folgt aufgerufen werden:

• Eingabeaufforderung: Öffnen Sie eine erhöhte Eingabeaufforderungsinstanz, und verwenden Sie den Befehl cd am Speicherort des Diagnosetools. Verwenden Sie dann eines der unten aufgeführten Argumente.
• Windows PowerShell: Navigieren Sie zum Speicherort des Diagnosetools, klicken Sie mit der rechten Maustaste darauf, und wählen Sie aus, ob es in PowerShell geöffnet werden soll. Verwenden Sie dann die unten aufgeführten Argumente.

Beispiel:

UiPath.DiagnosticTool.exe run <[defaultProfile] | [pathToProfile> [Optional Parameter]

Argument	Beschreibung
run studio	Führt das Studio-Standardprofil aus.
run orchestrator	Führt das Orchestrator-Standardprofil aus.
run <pathToFile>	Führt ein zuvor erstelltes, benutzerdefiniertes Diagnoseprofil aus einer generierten .json-Datei aus.
-o, --output	Gibt die Ausgabe des generierten .zip-Pakets an, das alle gesammelten Daten enthält.

Generieren eines Berichts für das Diagnosetool

So generieren Sie einen Diagnosetool-Bericht:

1. Klicken Sie auf Start und suchen Sie nach der Anwendung „UiPath-Diagnosetool“.
2. Wählen Sie die entsprechenden Optionen im Abschnitt Start aus und klicken Sie auf Weiter.
3. Konfigurieren Sie die Daten im Abschnitt Konfigurieren und klicken Sie auf Erfassen.
   Hinweis: Ein Bestätigungsfenster zum Löschen des aktuellen Fortschritts wird angezeigt, wenn Sie auf Zurück klicken.
4. Überprüfen Sie die Daten im Abschnitt Vorschau und klicken Sie auf Weiter.
5. Klicken Sie im Abschnitt Exportieren auf Exportieren.
6. Speichern Sie die generierte ZIP-Datei auf Ihrer Maschine.
7. Senden Sie die generierte ZIP-Datei Datei an das Team des technischen Supports senden.