Abonnieren

UiPath Robot

Anleitung für UiPath Robot

Protokollierungs- und Protokollstufen

Beschreibung

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.

640640

Protokollierungsstufen in UiPath

Log LevelLoggedExample / CommentLog FileOutput PanelOrchestrator Log page
VerboseActivitiesTrace {"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"}
YesNoYes
VerboseVariables"Variables":{"NewTransaction":"False"}}YesNoYes
VerboseArguments (properties)"Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}YesNoYes
TraceActivitiesTrace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"}
Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.Statements.Flowchart"}
YesNoYes
TraceWriteLineTrace {"message":"write","level":"Trace","logType":"User","timeStamp":"","fingerprint":"","windowsIdentity":"","machineName":"","processName":"New Process","processVersion":"","jobId":"","robotName":"","machineId":,"organizationUnitId":}YesYesYes
InformationLog MessageInfo {"message":"message from activity"
Note: Except messages logged with Trace level set in activity.
WarningWarningsWarn {"message":"Warning from log message activity"YesYesYes
WarningErrorsError {"message":"Error from log message activity"YesYesYes
WarningCriticalCritical ErrorsYesYesYes
ErrorErrorsError {"message":"Error from log message activity"YesYesYes
ErrorCritical
Fatal
Critical ErrorsYesYesYes
CriticalCritical
Fatal
Critical ErrorsYesYesYes
OFFn/an/aNoNoNo

Protokollierungsstufen in UiPath

Logging LevelDefault LogsUser-Defined Logs
OffNoneNone
CriticalAll messages logged with Critical level or higher.All messages logged with Critical level or higher.
ErrorAll messages logged with Error level or higher.All messages logged with Error level or higher.
WarningAll messages logged with Warning or higher.All messages logged with Warning or higher.
InformationAll messages logged with Information or higher.All messages logged with Information or higher.
TraceAll messages logged with Trace level or higher.All messages logged with Trace level or higher.
VerboseAll messages logged with Trace level and Workflow Tracking logs.All messages logged with Trace level.

Auf der Stufe Ausführlich (Verbose) wird sowohl eine Meldung für den Aktivitätsstart als auch das Aktivitätsende 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 Reihenfolge der Priorität der Protokolltypen lautet: Ausführlich (Verbose) < Rückverfolgung (Trace) < Information < Warnung (Warning) < Fehler (Error) < Kritisch < Aus.

Über PII-Informationen in Protokollen

Information, Warning, Error und Critical

Die Werte von Eingabe-/Ausgabeargumenten werden nicht nachverfolgt, wenn die Protokollebenen Information, Warning, Error und Critical verwendet werden. Das bedeutet, dass keine PII-Informationen in die Orchestrator Protokolle gesendet werden, es sei denn, sie wurden explizit aus Studio hinzugefügt.

Trace und Verbose

Die Protokollebenen Trace und Verbose verfolgen und schreiben die Werte von Eingabe-/Ausgabeargumenten in Orchestrator-Protokollen. Enthalten diese Werte PII-Informationen, dann werden sie den Orchestrator-Protokollen hinzugefügt.

Verwenden von excludeLoggedData zum Ausblenden vertraulicher Informationen

Mit der Variable excludedLoggedData können Sie Schlüsselwörter hinzufügen, um zu verhindern, dass Variablen- und Argumentwerte auf der Stufe Verbose protokolliert werden.

That can also be achieved by selecting the Private checkbox of any activity. Read more about the protection of sensitive information here.

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

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

  • Message - The log message.
  • Level - Defines the log severity.
  • Timestamp - The exact date and time the action was performed.
  • FileName - The name of the .xaml file being executed.
  • jobId * - The key of the job running the process.
  • processName * - The name of the process that triggered the logging.
  • processVersion * - The version number of the process.
  • windowsIdentity - The name of the user that performed the action that was logged.
  • robotName * - The name of the Robot (as defined in Orchestrator).
  • machineName - The name of the robot machine.
  • machineId * - The id of the robot machine.
  • organizationUnitId * - The ID of the Orchestrator organization.

* Log fields marked with an asterisk cannot be overridden using the Add Log Fields activity.

📘

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
  • initiatedBy

Transaktionsende

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

Debuggingprotokoll

activityInfo, was eine JSON-Meldung mit den folgenden Feldern ist:

  • DisplayName
  • State(Faulted,Closed,Executing)
  • Aktivität
  • Argumente

📘

Hinweis:

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

Benutzerdefinierte Felder

These fields are defined in Studio by using the Add Log Fields activity and appear in all subsequent logs after the activity is generated, unless they are removed by the Remove Log Fields activity.

🚧

Wichtig!

When defining Custom Log Fields make sure to also check the naming against the Default Log Fields to avoid conflicting information in the Log Files over the same Log Fields.

Having the same naming convention for both Custom and Default Log Fields can also impact the Process you are running.

Updated 23 days ago



Protokollierungs- und Protokollstufen


Auf API-Referenzseiten sind Änderungsvorschläge beschränkt

Sie können nur Änderungen an dem Textkörperinhalt von Markdown, aber nicht an der API-Spezifikation vorschlagen.