Protokollierungsstufen

Protokollierungsstufen in UiPath

Protokollierungsstufe	Standardprotokolle	Benutzerdefinierte Protokolle
Aus	Keine	Keine
Kritisch	Alle mit der Stufe Kritisch oder höher protokollierten Meldungen.	Alle mit der Stufe Kritisch oder höher protokollierten Meldungen.
Fehler (Error)	Alle mit der Stufe Fehler oder höher protokollierten Meldungen.	Alle mit der Stufe Fehler oder höher protokollierten Meldungen.
Warnung	Alle mit der Protokollierungsstufe Warnung oder höher protokollierten Meldungen.	Alle mit der Protokollierungsstufe Warnung oder höher protokollierten Meldungen.
Informationen	Alle Meldungen werden mit der Stufe Information oder einer höheren Stufe protokolliert.	Alle Meldungen werden mit der Stufe Information oder einer höheren Stufe protokolliert.
Ablaufverfolgung	Alle Meldungen werden mit der Stufe Trace oder einer höheren Stufe protokolliert.	Alle Meldungen werden mit der Stufe Trace oder einer höheren Stufe protokolliert.
Ausführlich	Alle Meldungen werden mit der Stufe Trace und in Workflow Tracking-Protokollen gespeichert.	Alle Meldungen werden mit der Stufe Trace protokolliert.

Auf der Stufe Verbose wird sowohl eine Meldung für den Start als auch für das Ende der Aktivität protokolliert, sowie die Werte der verwendeten Variablen und Argumente.

Standardmäßig umfasst die Stufe Verbose:

• Ausführung gestartet-Protokolleintrag – wird jedes Mal erzeugt, wenn ein Prozess gestartet wird.
• Ausführung beendet-Protokolleintrag – wird jedes Mal erzeugt, wenn ein Prozess finalisiert wird.
• Transaktion gestartet-Protokolleintrag – wird jedes Mal erzeugt, wenn der Roboter ein Transaktionsobjekt von Orchestrator erhält.
• Transaktion beendet-Protokolleintrag – wird jede Mal erzeugt, wenn der Roboter den Transaktionsstatus entweder auf Erfolgreich oder Fehlgeschlagen setzt.

• Aktivitätsinformationen-Protokolleintrag – wird jedes Mal erzeugt, wenn eine eine Aktivität in einem Workflow gestartet, mit Fehler beendet oder beendet wurde.

  Hinweis: Die Prioritätsreihenfolge der Protokolltypen ist: Ausführlich < Ablaufverfolgung < Information < Warnung < Fehler < Kritisch < Aus.

  Protokollierungsstufe	Protokolliert	Beispiel/Kommentar	Protokolldatei	Ausgabebereich	Die Seite Orchestrator-Protokoll
  Ausführlich	Aktivitäten	Ablaufverfolgung {"message":{"DisplayName":"Message box","State":"Executing","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":{"Caption":"","Text":"String in message BOX"}...	Ja	Nein	Ja
  Ausführlich	Variablen	"Variables":{"NewTransaction":"False"}}	Ja	Nein	Ja
  Ausführlich	Argumente (Eigenschaften)	„Argumente“:{"Caption":"","Text":"String in Message BOX","ChosenButton":"Ok"}	Ja	Nein	Ja
  Ablaufverfolgung	Aktivitäten	Ablaufverfolgung {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"}	Ja	Nein	Ja
  Informationen	Zeile schreiben (WriteLine) Protokollmeldung	Info {"message":"message from activity" Hinweis: Außer Meldungen, die mit festgelegter Trace-Rückverfolgungsstufe in der Aktivität protokolliert werden.	Ja	Ja	Ja
  Warnung	Warnungen	Warn {"message":"Warning from log message activity"	Ja	Ja	Ja
  Warnung	Fehler	Error {"message":"Error from log message activity"	Ja	Ja	Ja
  Warnung	Kritisch	Kritische Fehler	Ja	Ja	Ja
  Fehler (Error)	Fehler	Error {"message":"Error from log message activity"	Ja	Ja	Ja
  Fehler (Error)	Kritisch Schwerwiegend (Fatal)	Kritische Fehler	Ja	Ja	Ja
  Kritisch	Kritisch Schwerwiegend (Fatal)	Kritische Fehler	Ja	Ja	Ja
  AUS (OFF)	n. a.	n. a.	Nein	Nein	Nein

Typen von Protokollmeldungen

Abhängig vom Ereignis, das protokolliert wird, gibt es mehrere verschiedene Möglichkeiten, dass Protokollmeldungen vorkommen, und zwar:

Standardprotokolle

Wird standardmäßig erzeugt, wenn die Ausführung eines Projekts beginnt und endet, wenn ein Systemfehler auftritt und die Ausführung angehalten wird oder wenn die Protokollierungseinstellungen so konfiguriert sind, dass Ausführung jeder Aktivität protokolliert wird.

Hinweis: Diese Protokolle haben den Wert Default im Feld logType.

Die von dieser Kategorie protokollierten Ereignisse sind:

• Ausführungsstart wird jedes Mal erzeugt, wenn ein Prozess gestartet wird. Diese wird beginnend ab der Protokollierungsstufe Information protokolliert.
• Ausführungsende wird jedes Mal erzeugt, wenn ein Prozess beendet wird. Diese wird beginnend ab der Protokollierungsstufe Information protokolliert.
• Transaktionsstart wird jedes Mal erzeug, wenn eine Transaktion innerhalb eines Prozesses gestartet wird. Dies wird beginnend ab der Protokollierungsstufe Information protokolliert.
• Transaktionsende wird jede Mal erzeugt, wenn eine Transkation innerhalb eines Prozess abgeschlossen wird. Dieses wird beginnend ab der Protokollierungsstufe Information protokolliert.
• Fehlerprotokoll wird jedes Mal erzeugt, wenn die Ausführung auf einen Fehler trifft und angehalten wird. Dies wird beginnend ab der Protokollierungsstufe Fehler (Error) protokolliert.
• Debugging-Protokoll wird erzeugt, wenn die Einstellung für die Roboterprotokollierung auf Ausführlich festgelegt ist und enthält Aktivitätennamen, Typen, Variablennamen, Argumente usw. Dies wird beginnend ab der Protokollierungsstufe Rückverfolgung (Trace) protokolliert.

Benutzerdefinierte Protokolle

Wird entsprechend dem vom Benutzer in Studio konzipierten Prozess erzeugt, wenn die Aktivität Protokollmeldung (Log Message) oder die Aktivität Zeile schreiben (Write Line) verwendet wird.

Hinweis: Diese Protokolle haben den Wert User im Feld logType.

Protokollfelder

Es gibt mehrere Typen an Protokollfeldern, die über alle oben genannten Protokollmeldungstypen zu finden sind. Diese können wie folgt klassifiziert werden:

Standardfelder

Diese Protokollfelder sind für alle Ausführungstypen vorhanden, wie SQL (falls konfiguriert), Elasticsearch (falls konfiguriert) und die Standardprotokolle der Ereignisanzeige:

• Message – die Protokollmeldung.
• Level – Definiert den Schweregrad der Protokollierung.
• Timestamp – Datum und Uhrzeit, wann die Aktion durchgeführt wurde.
• FileName – Der Name der Datei .xaml, die ausgeführt wird.
• jobId – Der Schlüssel des Jobs, der den Prozess ausführt.
• processName – Der Name des Prozesses, der die Protokollierung ausgelöst hat.
• processVersion – Die Versionsnummer des Prozesses.
• windowsIdentity – Der Name des Benutzers, der die protokollierte Aktion durchgeführt hat.
• robotName – Der Name des Roboters (wie in Orchestrator definiert).

In einer Umgebung mit mehreren Robotern auf einer Maschine, die mit Orchestrator verbunden sind, zeigt die Ergebnisanzeige eventuell die folgende Meldung an: "Aktueller Benutzer hat sich nicht bei der Anwendung angemeldet!". Dies tritt nur dann auf, wenn Sie einen Roboter entfernen, der noch Protokolle an Orchestrator senden musste.

Hinweis: Die Felder processName und processVersion erscheinen nicht in den Protokollen, wenn der Prozess lokal ohne Verbindung zu Orchestrator ausgeführt wird.

Typspezifische Felder

Diese Protokolle sind abhängig vom Protokolltyp vorhanden:

Ausführung beendet

• totalExecutionTimeInSeconds
• totalExecutionTime

Transaktionsstart

• Warteschlangenname (QueueName)
• transactionID
• transactionState

Transaktionsende

• Warteschlangenname (QueueName)
• transactionID
• transactionState
• transactionStatus
• Transaktionsausführungszeit
• Der Typ Verarbeitungsausnahme
• Grund für Verarbeitungsausnahme
• queueItemReviewStatus
• queueItemPriority

Debuggingprotokoll

• activityInfo, was eine JSON-Meldung mit den folgenden Feldern ist:
  • DisplayName
  • State (Mit Fehler beendet, Geschlossen, Wird ausgeführt)
  • Aktivität
  • Variablen

  • Arguments

    Hinweis: totalExecutionTimeInSeconds, totalExecutionTime und queueName sind immer in den Protokollmeldungen vorhanden. Variables und Arguments haben üblicherweise Unterfelder.

Benutzerdefinierte Felder

Diese Felder werden in Studio mithilfe der Aktivität Protokollfelder hinzufügen (Add Log Fields) erzeugt, und sie erscheinen in allen nachfolgenden Protokollen, nachdem die Aktivität erzeugt wurde, wenn sie nicht durch die Aktivität Protokollfelder entfernen (Remove Log Fields) entfernt werden.

Hinweis:

Das Erstellen von benutzerdefinierten Protokollfeldern mit dem gleichen Namen wie ein Standardprotokollfeld bewirkt, dass der Protokollierungsprozess beschädigt wird und Probleme im ausgeführten Workflow auftreten können.

Zum Beispiel verursacht die Erstellung eines benutzerdefinierten Protokollfelds mit dem Namen jobId dieses Problem, da jobId ein standardmäßig angelegtes Protokollfeld ist.