Grundlegendes zu Roboterprotokollen

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:

• Die Event Viewer-Systemanwendung – unter Windows.

• %LocalAppData%\UiPath\Logs\internal\Robot.log – Für Benutzermodusroboter unter Windows-Betriebssystemen.
• %PROGRAMDATA%\UiPath\Logs\internal\Robot.log – Für Dienstmodusroboter unter Windows-Betriebssystemen.
• ~/Library/Application Support/UiPath/Logs/internal/Robot.log – Unter Mac-Betriebssystemen.

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.

Treiberdiagnoseprotokolle werden in eine .etl-Datei geschrieben. Es wird empfohlen, die Treiberablaufverfolgung nur während einer Problemuntersuchung zu aktivieren und sie dann zu deaktivieren, wenn die Untersuchung beendet ist. Die .etl-Datei mit den Ablaufverfolgungsinformationen wird erst generiert, nachdem Sie die Funktion deaktiviert haben.

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.