Protokollstufen

Roboterprotokollebenen von „Aus“ bis „Verbose“, konfigurierbar in Assistant oder Orchestrator.

Überblick

Die Protokollebene bezieht sich darauf, wie detailliert die generierte Nachricht sein soll. Sie können sie konfigurieren über:

• die Einstellung Protokollebene unter Assistant > Einstellungen > Seite Allgemein. Standardmäßig ist dies auf Information festgelegt.
• die Einstellung Protokollierungsstufe unter Orchestrator > Zugriff verwalten > Benutzer > „Benutzer- oder Roboterkonto“ > Seite Robotereinstellungen. Standardmäßig ist dies auf Information festgelegt.
  Hinweis:

  Die Protokollstufe, die Sie im Orchestrator festgelegt haben, überschreibt die im Assistant konfigurierte Stufe.

Hinweis:

Ab Version 2025.10.1 unterstützt der Robot zwei verschiedene Protokollebenen: eine für die an Orchestrator gesendeten Protokolle und eine weitere für lokale Dateien. Um die Protokollebene auf lokal festzulegen, verwenden Sie die UIPATH_FILE_LOG_LEVEL Umgebungsvariable wie hier beschrieben.

UiPath verwendet die folgenden Protokollebenen, die in aufsteigender Reihenfolge ihrer Priorität aufgeführt sind.

• Aus – Es werden keine Protokolle gespeichert. Diese Ebene wird in der Regel verwendet, um die Protokollierung zu deaktivieren.

• Verbose – Berichte mit einer noch feineren Granularität, die jedes mögliche Detail über die Automatisierungsvorgänge protokollieren. Dies können Informationen über Variablenänderungen, Funktionsaufrufe oder sogar externe Antworten sein. Zeigt alle Protokolle mit der Stufe Ablaufverfolgung an. Standardmäßig enthält die Stufe „Verbose“ die folgenden Protokolleinträge:

  • Ausführung gestartet – Wird jedes Mal erstellt, wenn ein Prozess gestartet wird.
  • Ausführung beendet – Wird jedes Mal erzeugt, wenn ein Prozess finalisiert wird.
  • Transaktion gestartet – Wird jedes Mal erzeugt, wenn der Roboter ein Transaktionselement vom Orchestrator erhält.
  • Transaktion beendet – Wird jedes Mal erzeugt, wenn der Roboter den Transaktionsstatus entweder auf Erfolgreich oder Fehlgeschlagen setzt.
  • Aktivitätsinformationen – Werden jedes Mal erzeugt, wenn eine Aktivität in einem Prozess gestartet, mit Fehler beendet oder beendet wurde.

  The Robot sends at most 10,000 Verbose logs per Executor process. The limit counts only the entries the Robot writes at the Verbose level, in practice the Activity Information logs. Entries it writes at higher levels, such as Execution Started and Execution Ended (Information level), don't count toward it. When the process reaches the limit, the Robot logs the warning "Verbose log limit exceeded, further verbose logs from this job will be dropped." and drops the Verbose logs that follow. The limit applies only to the logs sent to Orchestrator, not to the local log file. Logs you add with the Log Message activity don't count toward the limit. To change the limit, set the UIPATH_VERBOSE_LOG_LIMIT environment variable, as described in Configuration files. Values of 0 or lower are ignored and the default is used instead.

• Trace – Diese Protokolle enthalten die detailliertesten Informationen, die häufig zum Debuggen oder Verfolgen bestimmter Ausführungspfade von Aufgaben innerhalb des Systems verwendet werden. Zeigt alle Protokolle mit den Stufen Trace, Information, Warnung, Fehler und Kritisch an.

• Information – Informationsprotokolle bieten allgemeine Einblicke in die Automatisierungsausführung, z. B. Beginn und Ende von Aufgaben. Zeigt alle Protokolle mit den Stufen Information, Warnung, Fehler und Kritisch an.

• Warnung – Diese Protokolle enthalten kleinere Vorgänge oder mögliche Probleme, die sich nicht unmittelbar auf den aktuellen Betrieb auswirken, aber in Zukunft von Bedeutung sein könnten. Zeigt alle Protokolle mit den Stufen Warnung, Fehler und Kritisch an.

• Fehler – Protokolle, die auf dieser Ebene erstellt werden, enthalten Details zu Fehlern, die während der Ausführung aufgetreten sind und die den normalen Betrieb des Workflows verhindern, aber nicht das gesamte System zum Stillstand bringen. Zeigt alle Protokolle mit den Stufen Fehler und Kritisch an.

• Kritisch – Protokolle, die auf ein kritisches Problem oder einen Fehler hinweisen, werden aufgezeichnet. Probleme, die schwerwiegend genug sind, um sofortige Aufmerksamkeit zu erfordern, werden normalerweise auf dieser Ebene protokolliert.

Vertrauliche Informationen in Protokollen

Die Protokollebenen Information, Warnung, Fehler und Kritisch verfolgen keine Eingabe-/Ausgabeargumentwerte. Dadurch wird sichergestellt, dass sensible Daten nicht in den Orchestrator-Protokollen enthalten sind, es sei denn, sie werden absichtlich von UiPath Studio hinzugefügt.

Im Gegensatz dazu verfolgen und zeichnen die Protokollebenen Ablaufverfolgung und Verbose die Werte von Eingabe-/Ausgabeargumenten, einschließlich vertraulicher Daten, in Orchestrator-Protokollen auf.

To hide sensitive information at the Verbose levels, you can use the excludedLoggedData setting in the runtimeOptions section of the project's project.json file, and provide specific keywords. By default, the list contains Private:* and *password*. For example:

"excludedLoggedData": [
      "Private:*",
      "*password*"
    ],

Beim Konfigurieren von Aktivitäten können Sie das Kontrollkästchen Privat aktivieren, um dasselbe zu erreichen. Weitere Informationen finden Sie unter Schutz vertraulicher Informationen.