Grundlegendes zu Roboterprotokollen

Roboter-Ausführungsprotokolle und Diagnoseprotokolle: was sie enthalten, wo sie gespeichert werden und wie sie an Orchestrator gesendet werden.

Protokolle sind Dateien mit Zeitstempeln, die informative Ereignisse, Fehler- und Warnmeldungen enthalten, die für die Ausführung des Roboters relevant sind.

Roboter-Ausführungsprotokolle

Ausführungsprotokolle sind Meldungen, die bei der Ausführung einer Automatisierung erzeugt werden. Sie enthalten Details zu den Aktionen der Automatisierung und benutzerdefinierten Nachrichten. Nur Protokolle, die der in den Assistant- oder Orchestrator-Einstellungen angegebenen Stufe entsprechen, werden an den Orchestrator gesendet.

Ausführungsprotokolle werden als Text-Dateien (.log-Format) und LiteDB-Dateien generiert. Wenn die Verbindung zum Orchestrator verloren geht, werden Protokolle in der LiteDB-Datei gespeichert. Sobald die Verbindung wiederhergestellt ist, werden Protokolle an den Orchestrator gesendet und aus LiteDB gelöscht. Auch wenn die Verbindung zum Orchestrator unterbrochen wird, gehen die Protokolle nicht verloren.

Roboter-Diagnoseprotokolle

Roboter-Diagnoseprotokolle sind interne Protokolle, die Details über das Verhalten des Roboters und den Kontext enthalten, in dem er Automatisierungen ausführt. Zum Beispiel können sie Informationen darüber enthalten, wie der Roboter mit verschiedenen Softwareanwendungen interagiert oder wie er Systemressourcen verwaltet. Wenn ein Fehler auftritt, enthalten diese Protokolle die genauen Bedingungen und Aktionen, die zu dem Fehler geführt haben.

Das System speichert Roboterdiagnoseprotokolle an den folgenden Speicherorten:

• The Event Viewer system application, in the Application log - on Windows OSs. Event Viewer receives only errors, with the source UiPath.
• %LocalAppData%\UiPath\Logs\internal\Robot.log – Für Benutzermodusroboter unter Windows-Betriebssystemen.
• %PROGRAMDATA%\UiPath\Logs\internal\Robot.log – Für Dienstmodusroboter unter Windows-Betriebssystemen.
• ~/.local/share/UiPath/Logs/internal/Robot.log - on Linux operating systems.

Robot.log rolls over at 25 MB and keeps the two most recent archives. It also holds the diagnostic logs of the host process that runs executor packages for agents, functions, and API workflows. Those entries start with [ExecutorsHost].

Treiberdiagnoseprotokolle

Treiberdiagnoseprotokolle enthalten Details über die Kommunikation und Interaktionen zwischen dem Roboter und bestimmter Hardware über einen Treiber. Beispielsweise muss der Roboter mit einem Roboter interagieren, um Dokumente im Rahmen der Automatisierung auszudrucken. Diese Protokolle können dabei helfen, festzustellen, ob das Problem beim Treiber selbst liegt oder in der Art und Weise, wie der Roboter mit dem Treiber kommuniziert.

Driver diagnostic logs are written to an .etl file. Enable driver tracing only during a problem investigation, and disable it when the investigation is over. The .etl file containing the trace information is generated only after you disable the feature.

Standardmäßige und benutzerdefinierte Protokolle

Die folgenden Ereignisse werden standardmäßig vom Roboter während der Ausführung einer Automatisierung protokolliert. Diese Einträge sind in der Protokolldatei im Feld logType als Standard gekennzeichnet.

• Ausführungsstart – Wird jedes Mal protokolliert, wenn eine Automatisierung startet, ab der Stufe Information und höher.
• Ausführungsende – Wird jedes Mal protokolliert, wenn eine Automatisierung beendet wird, ab der Stufe Information und höher.
• Transaktionsstart – Wird jedes Mal zu Beginn einer Transaktion innerhalb einer Automatisierung protokolliert, ab der Stufe Information und höher.
• Transaktionsende – Protokolliert nach Abschluss jeder Transaktion innerhalb einer Automatisierung, ab der Stufe Information und höher.
• Fehler – Wird jedes Mal protokolliert, wenn die Ausführung auf einen Fehler trifft und angehalten wird, mit der Stufe Fehler oder höher.
• Debugging – Wird protokolliert, wenn die Protokollierungseinstellung im Orchestrator auf Verbose festgelegt ist, wobei die Stufe Ablaufverfolgung oder höher verwendet wird. Sie enthält Details wie Aktivitätsnamen und -typen, Variablenwerte oder Argumente.

Verwenden Sie die folgenden Aktivitäten, um angepasste oder vom Benutzer definierte Protokolle zu erstellen:

• Aktivität Write Line – Erstellt Protokolle auf der Stufe Ablaufverfolgung.
• Aktivität Log Message – Erstellt Protokolle auf der im Eigenschaftsfeld LogLevel ausgewählten Stufe.

Benutzerdefinierte Protokolle werden durch den Wert Benutzer im Feld logType in der Protokolldatei identifiziert.