Über Protokolle

Überblick

Die Seite Protokolle zeigt von Robot-Instanzen generierte Protokolle in allen Ordnern an, auf die Sie Zugriff haben.

Um darauf zuzugreifen, navigieren Sie aus einem Kontext „Ordner“ zur Orchestrator-Registerkarte Automatisierungen und wählen Sie Protokolle aus den angezeigten Optionen aus.

Hinweis: Protokolle, die außerhalb des Kontexts eines Ordners generiert werden, können nur in der Orchestrator-Datenbank und Elasticsearch angezeigt werden.

Filtern

Um alle Protokolle anzuzeigen, die von einem Roboter für einen angegebenen Auftrag generiert wurden, navigieren Sie zur Seite Aufträge, klicken Sie auf das 3-Punkte-Menü des jeweiligen Auftrags und wählen Sie Protokolle anzeigen aus.

Zum Filtern von Protokollen, die von Robotern in allen Ordnern generiert wurden, auf die Sie Zugriff haben, öffnen Sie die Seite Protokolle und verwenden Sie die gewünschten Filter. Beachten Sie, dass einige Filter standardmäßig angewendet werden, z. B. Zeit, die auf Letzter Tag festgelegt ist. Um alle Protokolle anzuzeigen, entfernen Sie alle Filter.

Um Protokolle nach dem Namen der Hostmaschine zu filtern, auf der sie generiert wurden, verwenden Sie den Filter Maschine auf der Seite Protokolle. Der Filter funktioniert rückwirkend für Protokolle, die in Elasticsearch gespeichert sind, während er für Protokolle, die in der Datenbank gespeichert sind, nur bei neuen Einträgen funktioniert.

Protokollspeicher

Wenn der Orchestrator nicht verfügbar ist, werden die Protokolle in einer lokalen Datenbank (C:\Windows\SysWOW64\config\systemprofile\AppData\Local\UiPath\Logs\execution_log_data) innerhalb des verfügbaren Platzes auf der Festplatte gespeichert, bis die Verbindung wiederhergestellt wird. Ist die Verbindung wiederhergestellt, werden die Protokolle in Batches in der Reihenfolge gesendet, in der sie erzeugt wurden.

Hinweis: Die Datenbank wird nicht gelöscht, nachdem die Protokolle erfolgreich an Orchestrator gesendet wurden.

Der Status eines Auftrags wird im Speicher des UiPath Robot-Dienstes gespeichert. Ist der Orchestrator verfügbar, werden Informationen in Hinblick auf den Auftragsstatus zwischen den beiden synchronisiert. Falls der Orchestrator aber nicht verfügbar ist und Sie den UiPath Robot-Dienst neu starten, gehen die Informationen verloren. Dies bedeutet, dass der Auftrag, sobald der Orchestrator wieder verfügbar ist, erneut ausgeführt wird.

Protokolle können an ElasticSearch, eine lokale SQL-Datenbank bzw. UiPath Insights gesendet werden, sodass Sie Protokolle erhalten, die nicht zurückgewiesen werden können. Sie sind unabhängig voneinander, somit wirkt sich ein Problem vom einen nicht auf andere aus.

Die Seite Protokolle zeigt die Einträge an, welche die Roboter an den Orchestrator senden, wenn die Protokolle an Elasticsearch oder eine SQL-Datenbank gesendet werden. Wenn Protokolle sowohl an Elasticsearch als auch SQL gesendet werden, dann zeigt die Seite Protokolle nur die Einträge an, die an Elasticsearch gesendet wurden.

Hinweis:

Die Leistung der SQL-Datenbank beginnt sich zu verschlechtern, wenn sie 2 Millionen Roboterprotokolle erreicht, mit einer schwerwiegenden Beeinträchtigung, sobald der Schwellenwert von 6 Millionen erreicht ist. Die Beeinträchtigung führt zu langsamen Protokollsuchen und wirkt sich auf die Leistung Ihrer Automatisierungen aus.

Diese Schwellenwerte stellen unsere beobachteten Durchschnitte dar. Je nach Datenbankserver-Hardware können die Werte entweder kleiner oder größer sein (um das 2- bis 3-Fache).

Sie müssen die Datenbank regelmäßig bereinigen, um sicherzustellen, dass Sie innerhalb dieser Grenzen bleiben.

Wenn Ihre geschäftlichen Anforderungen es jedoch erfordern, dass Sie diese Schwellenwerte überschreiten, müssen Sie Elasticsearch verwenden, um die Leistung aufrechtzuerhalten.

Wenn Sie Elasticsearch zum Speichern Ihrer Roboterprotokolle verwenden, beachten Sie bitte, dass unter bestimmten Umständen nur 10.000 Elemente abgefragt werden können.

Aufgrund einer Elasticsearch-Beschränkung sind die Orchestrator-Mandanten von Cloud Platform so konfiguriert, dass Roboterprotokolle über 50 kb ignoriert werden. Die überwiegende Mehrheit der Protokolle hat durchschnittlich 2 kb.

Protokollierungsstufen

Meldungen werden auf den folgenden Stufen protokolliert: Rückverfolgung (Trace), Fehler beseitigen (Debug), Info, Warn, Fehler (Error) und Schwerwiegend (Fatal).

Benutzerdefinierte Nachrichten können auch an diese Seite von Studio, mit der Aktivität Protokollmeldung (Log Message) gesendet werden. Die Meldungen können auf allen oben beschriebenen Ebenen protokolliert werden und sollten zu Diagnosezwecken verwendet werden.

Zum Beispiel sehen Sie im nachfolgenden Screenshot, dass wir eine benutzerdefinierte Meldung mit dem Schweregrad Fatal protokolliert haben.

Protokolle exportieren

Alle Protokolle können durch einen Klick auf die Schaltfläche Exportieren (Export) in eine .csv-Datei exportiert werden. Die auf diese Seite angewendeten Filter werden berücksichtigt, wenn diese Datei generiert wird. Wenn Sie beispielsweise einstellen, nur Protokolle der letzten 30 Tage mit einer Schweregrad-Info anzusehen, werden nur die Einträge, die diese Kriterien erfüllen, heruntergeladen.

Um beste Leistung sicherzustellen, beachten Sie bitte, dass die exportierten Einträge nicht in umgekehrter chronologischer Reihenfolge aufgeführt sind.

Bitte beachten Sie, dass Protokolle im folgenden Szenario eventuell nicht in der richtigen Reihenfolge angezeigt werden:

• Es gibt zwei oder mehr Roboterprotokolleinträge mit beinahe gleichen Zeitstempeln – sie sind bis auf die Millisekunde gleich (die in yyyy-MM-dd HH\:mm\:ss.fff ausgedrückte Zeit ist dieselbe), aber sie unterscheiden sich in den Untereinheiten der Millisekunde (die letzten vier Werte in yyyy-MM-dd HH\:mm\:ss.fffffff unterscheiden sich).
• Die Protokolle werden in Orchestrator mit der Standardsortierreihenfolge im Raster angezeigt (nach absteigender Zeit sortiert).

Dies hat jedoch keine Auswirkungen auf die Datenbank und die exportierte .csv- Datei.

Hinweis: Beide Serverausnahmen von Orchestrator und der Stacktrace im Feld Info im Fenster Jobdetails (Job Details) werden unabhängig von der vom Benutzer gewählten Sprache in englischer Sprache angemeldet.

Berechtigungen

Sie benötigen im Ordner-Kontext die Berechtigung zum Anzeigen für Protokolle, um Zugriff auf Protokolle zu erhalten, die in einem Ordner generiert wurden.