robot
2020.10
false
Wichtig :
Bitte beachten Sie, dass dieser Inhalt teilweise mithilfe von maschineller Übersetzung lokalisiert wurde.
Kein Support
Roboter-Benutzerhandbuch
Last updated 1. Juli 2024

Protokollierungs- und Protokollstufen

Während der Prozessausführung generiert der Roboter für jeden Schritt eine Nachricht (Protokoll). Diese werden gesammelt und in einer Protokolldatei gespeichert. Der gesamte Vorgang zum Sammeln und Speichern der Protokolle wird als Protokollierung bezeichnet.

Jedes Protokoll verfügt über eine Protokollebene, die sich darauf bezieht, wie detailliert die generierte Nachricht ist.

Protokollierungsebenen beziehen sich auf den Schweregradtyp, der in der Protokolldatei angegeben ist.

Protokollierungsstufen in UiPath

Protokollierungsstufe

Protokolliert

Beispiel/Kommentar

Protokolldatei

Ausgabebereich

Die Seite Orchestrator-Protokoll

Ausführlich

Aktivitäten

Trace {"message":{"DisplayName":"Message box","State":"Executing","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":{"Caption":"","Text":"String in message BOX"}...
Trace {"message":{"DisplayName":"Message box","State":"Closed","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}

Ja

Nein

Ja

Ausführlich

Variablen

"Variables":{"NewTransaction":"False"}}

Ja

Nein

Ja

Ausführlich

Argumente (Eigenschaften)

"Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}

Ja

Nein

Ja

Ablaufverfolgung

Aktivitäten

Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"} Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.Statements.Flowchart"}

Hinweis: Diese Protokolle sind Teil der Workflow-Tracking-Protokolle und können nur auf der Verbose-Stufe angezeigt werden.

Ja

Nein

Ja

Ablaufverfolgung

Zeile schreiben (WriteLine)

Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"}

Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.Statements.Flowchart"}

Ja

Ja

Ja

Informationen

Protokollmeldung

Info {"message":"message from activity"

Hinweis: Außer Meldungen, die mit festgelegter Trace-Rückverfolgungsstufe in der Aktivität protokolliert werden.

   

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

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 Prozessgestartet, mit Fehler beendet oder beendet wurde.

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

Protokolltypen

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

Standard

Wird standardmäßig erzeugt, wenn die Ausführung eines Prozesses 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 Log (Level = Trace) wird erzeugt, wenn „Robot Logging Setting“ auf „Verbose“ gesetzt ist, und enthält Aktivitätennamen, Typen, Variablennamen, Argumente usw. Dies wird beginnend ab der Protokollierungsstufe Rückverfolgung (Trace) protokolliert.

Benutzerdefiniert

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

  • Nachricht (Message) - Die Protokollmeldung
  • Grad (Level) - Definiert den Protokoll-Schweregrad
  • Zeitstempel - 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.
  • ProzessName (processName) - Der Name des Prozesses, der die Protokollierung getriggert hat
  • processVersion - Die Versionsnummer des Prozesses
  • windowsIdentity - Der Name des eingeloggten Benutzers, der die Aktion durchgeführt hat.
  • robotName - Der Name des Roboters (in Orchestrator definiert)

    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
  • Status (State) (Faulted, Closed, Executing)
  • Aktivität
  • Argumente

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: Achten Sie beim Definieren benutzerdefinierter Protokollfelder darauf, auch die Benennung mit den Standardprotokollfeldern abzugleichen, um widersprüchliche Informationen in den Protokolldateien über dieselben Protokollfelder oder beschädigte Protokolldateien zu vermeiden. Die gleiche Namenskonvention für benutzerdefinierte und Standardprotokollfelder kann sich auch auf den ausgeführten Prozess auswirken.

War diese Seite hilfreich?

Hilfe erhalten
RPA lernen – Automatisierungskurse
UiPath Community-Forum
Uipath Logo White
Vertrauen und Sicherheit
© 2005–2024 UiPath. Alle Rechte vorbehalten