Roboter-Protokolle

Protokolle sind Dateien mit Zeitstempel, die informative Ereignisse, Fehler- und Warnmeldungen enthalten, die für die Anwendung relevant sind.

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 Jobs wird im Speicher des UiPath Robot-Dienstes gespeichert. Ist der Orchestrator verfügbar, werden Informationen in Hinblick auf den Jobstatus 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 Job, sobald der Orchestrator wieder verfügbar ist, erneut ausgeführt wird.

Roboter-Diagnoseprotokolle

Diese Protokolle liefern Informationen in Bezug auf den Roboter (Robot) selbst und dessen Kontext. Sie sind nützlich für die Identifizierung der Ursache eines bestimmten Fehlers.

Aktivierung der Roboter-Diagnoseprotokolle

Standardmäßig sind die Roboter-Diagnoseprotokolle aktiviert, und alle Meldungen auf den Stufen Fehler (Error) oder Warnung (Warning) werden protokolliert.

Wenn andere Stufen der Protokollierung benötigt werden, können diese aktiviert werden, sofern Low Level Tracing aktiviert ist. Standardmäßig ist diese Funktion deaktiviert.

Um Ablaufverfolgung auf niedriger Ebene zu aktivieren, führen Sie den Befehl UiRobot.exe --enableLowLevel in der Eingabeaufforderung aus.

Um Ablaufverfolgung auf niedriger Ebene zu deaktivieren, führen Sie den Befehl UiRobot.exe --disableLowLevel in der Eingabeaufforderung aus.

Die Aktivierung von Low Level Tracing als Administrator, lokaler oder Domänenbenutzer startet die Nachverfolgung auf unterer Stufe für die .etl-Datei. Dies aktiviert eine ausführliche Nachverfolgung für den Roboter-Executor und -Dienst in der Ereignisanzeige.

Vergessen Sie nicht, vorher das Installationsverzeichnis mithilfe des Arguments cd aufzurufen, beispielsweise cd C:\Program Files (x86)\UiPath\Studio.

Hinweis:

Es wird empfohlen, die Ablaufverfolgung auf niedriger Ebene nur zu aktivieren, während ein Problem untersucht wird, und sie zu deaktivieren, wenn die Untersuchung beendet ist.

Zudem wird die .etl-Datei mit den Ablaufverfolgungsinformationen erst generiert, nachdem Sie die Funktion deaktiviert haben.

Der Roboter muss nicht neu gestartet werden, damit die Änderungen wirksam werden.

Ziele der Roboter-Diagnoseprotokolle

Der Zielspeicherort der Protokolle wird von der Datei <Installation Folder>\NLog.configgesteuert. Die Diagnoseprotokolle werden vom internen Typ-Logger erfasst und mithilfe von NLog-Zielen weitergeleitet.

By default, Internal logs are sent to Event Viewer, as specified in the following lines from NLog.config:

<target xsi:type="EventLog" name="eventLog" layout="${callsite:className=false:includeSourcePath=true:methodName=false} ${message}" source="UiPath" log="Application" />
<logger name="Internal" minLevel="Trace" writeTo="eventLog" />

Hinweis:

Die Bearbeitung der Datei NLog.config erfordert Administratorberechtigungen. Der Dienst UiRobot.exe muss neu gestartet werden, wenn das Ziel Internal in der Datei NLog.config geändert wurde, damit die Änderungen wirksam werden.

Öffnen der .etl-Protokolldatei

Dieser Dateityp kann von der Ereignisanzeige aus geöffnet werden:

1. Im Bereich Actions der Ereignisanzeige klicken Sie Gespeichertes Protokoll öffnen an. Das Fenster Gespeichertes Protokoll öffnen wird angezeigt.

2. Navigieren Sie zur Datei mit dem erzeugten Nachverfolgungsprotokoll und klicken Sie auf Öffnen. Die Datei wird im linken Panel unter Gespeicherte Protokolle angezeigt.

3. Wählen Sie die Datei aus. Beachten Sie, dass die Inhalte der Protokolle angezeigt werden.

   

Roboter-Ausführungsprotokolle

Die Protokolle der Roboter-Ausführung sind Meldungen, die bei der Ausführung eines Prozesses erzeugt werden, und sie enthalten typischerweise Informationen zum Verhalten des Prozesses sowie benutzerdefinierte Meldungen.

Es gibt mehrere Möglichkeiten, wie Ausführungsprotokolle erzeugt werden können:

• Die Aktivität Zeile schreiben (Write Line) erstellt Protokolle auf der unteren Nachverfolgungsstufe.
• Die Aktivität Protokollmeldung (Log Message) erstellt Protokolle auf der Stufe, die im Eigenschaftsfeld Grad (Level) angegeben ist.
• Beim Ausführen eines Automationsprojekts werden Protokolle erstellt, die das Verhalten jeder Aktivität beinhalten. Diese Protokolle haben die Nachverfolgungsstufe, wenn die Einstellung Stufe (Level) im Fenster Orchestrator-Einstellungen (Orchestrator Settings) auf Verbose festgelegt ist.

Protokollierungsstufe der Ausführungsprotokolle

Die standardmäßige Protokollierungsstufe wird über die Einstellung Stufe (Level) im Fenster Orchestrator-Einstellungen (Orchestrator Settings) gesteuert. Standardmäßig ist sie auf Informationen (Information) festgelegt.

Änderung der standardmäßigen Protokollierungsstufe im Fenster Orchestrator-Einstellungen (Orchestrator Settings):

1. Öffnen Sie in UiPath Assistant zuerst das Menü „Einstellungen“ und dann Orchestrator-Einstellungen.

2. Wählen Sie die gewünschte Protokollierungsstufe im Dropdown-Menü Protokollstufe des Abschnitts Protokollierung.

   

   Hinweis:

   Wenn der Roboter (Robot) als Windows-Dienst installiert ist, ist eine Administratorberechtigung erforderlich, um diese Einstellung zu bearbeiten.

Ziele der Ausführungsprotokolle

By default, Execution Logs are stored in a file in the %LocalAppData%\UiPath\Logs folder. The messages are collected by the Execution type logger and can be forwarded by using NLog targets, as specified by the following parameters in the NLog.config file:

<target xsi:type="File" name="executionFile" fileName="${LogDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" concurrentWrites="true" />
<logger name="Execution" minLevel="Trace" writeTo="executionFile" final="true" />

If the Robot is connected to Orchestrator, all execution logs are sent to Orchestrator and can be seen in the Logs page.

Außerdem lassen sich die Ziele und der Inhalt der Protokolle durch Bearbeiten der Datei <Installation Folder>\NLog.config konfigurieren.

Hinweis:

Die Bearbeitung der Datei NLog.config erfordert Administratorberechtigungen. Der Roboter-Dienst muss nicht neu gestartet werden, damit die Änderungen wirksam werden.

Weitere Bearbeitung der Protokolle

Wenn die Protokollierungsstufe auf Ausführlich (Verbose) eingestellt ist, enthalten die Meldungen alle Einzelheiten über die Aktivitäten, die bei der Ausführung abgearbeitet wurden. Diese Protokollausgabe kann durch Bearbeitung der Datei UiPath.Executor.exe.config, die sich im Ordner C:\Program Files (x86)\UiPath\Studio befindet, benutzerspezifisch angepasst werden. Dazu muss XML-Code unter dem Tag <system.serviceModel> hinzugefügt werden. Zum Beispiel:

<tracking>
    <profiles>
        <trackingProfile name="StandardProfile">
         <workflow>
          <activityStateQueries>
            <activityStateQuery activityName="*">
                <states>
                    <state name="Faulted"/>
                </states>
                <arguments>
                    <argument name="*"/>
                </arguments>
                 <variables>
                    <variable name="*"/>
                </variables>
            </activityStateQuery>
          </activityStateQueries>
         </workflow>
        </trackingProfile>
    </profiles>
</tracking>

Da das Tag <states> nur <state name="Faulted"/> enthält, aktiviert das Einfügen des obigen Codes nur die Protokollierung von Aktivitäten, die den Zustand Faulted aufweisen. Das Hinzufügen weiterer Parameter unter dem Tag <states>, wie <state name="Executing"/>, führt dazu, dass Aktivitäten mit anderen Zuständen ebenfalls protokolliert werden.

Not only activity states can be modified, but also other things, such as variables and arguments. More information about customization can be found here.

Hinweis:

Eine Modifikation der Datei UiPath.Executor.exe.config erfordert einen Neustart des Roboter-Dienstes, damit die Änderungen wirksam werden.

Flush-Größe und Flush-Intervall

The Flush Size and Flush Interval can be changed from the Orchestrator UiPath.Orchestrator.dll.config settings. See the UiPath.Orchestrator.dll.config document for more details.

Hinweis:

Der Befehl, der die Protokolle an den Orchestrator sendet, triggert am Ende des für RobotsLogs.Flush.Interval festgelegten Zeitraums. Wenn sich Protokolle addieren und der Roboter vor Ablauf dieser Zeit getrennt wird, werden diese Protokolle gesendet, wenn der Roboter das nächste Mal eine Verbindung mit dem Orchestrator herstellt.