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\System32\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 die Ablaufverfolgung auf niedriger Ebene zu aktivieren, führen Sie den Befehl UiRobot.exe --enableLowLevel in der Eingabeaufforderung aus.

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

Die Aktivierung von Low Level Tracing (Ablaufverfolgung auf niedriger Ebene) als Administrator, lokaler oder Domänenbenutzer startet die Ablaufverfolgung auf niedriger Ebene für die .etl-Datei. Dies aktiviert eine ausführliche Ablaufverfolgung 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\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

Das Zielverzeichnis der Protokolle wird durch die Datei <Installation Folder>\NLog.config gesteuert. Die Diagnoseprotokolle werden durch den Internal-Protokollierer gesammelt und mithilfe von NLog targets weitergeleitet.

Standardmäßig werden interne Protokolle an die Ereignisanzeige geschickt, wie in den folgenden Zeilen von NLog.config angegeben:

<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: Für das Bearbeiten der Datei NLog.config benötigen Sie 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 als Windows-Dienst installiert ist, ist eine Administratorberechtigung erforderlich, um diese Einstellung zu bearbeiten.

Ziele der Ausführungsprotokolle

Standardmäßig werden Ausführungsprotokolle in einer Datei im Ordner %LocalAppData%\UiPath\Logs abgelegt. Die Meldungen werden vom WorkflowLogging-Logger gesammelt und können mithilfe von NLog-Zielen weitergeleitet werden, wie dies durch die folgenden Parameter in der Datei NLog.config angegeben ist:

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File" name="WorkflowLogFiles" fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" keepFileOpen="true" openFileCacheTimeout="5" concurrentWrites="true" encoding="utf-8" writeBom="true" />
  </targets>
</nlog>

Wenn der Roboter mit dem Orchestrator verbunden ist, werden alle Ausführungsprotokolle an den Orchestrator gesendet und können auf der Seite Protokolle eingesehen werden.

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

Löschen alter Protokolldateien

Um zu vermeiden, dass eine große Menge von Protokolldateien erstellt wird, die Speicherplatz auf der Maschine verbrauchen, können Sie Protokolldateien archivieren, sobald eine bestimmte Anzahl von Dateien erreicht wurde.

Dazu fügen Sie die folgenden Parameter im <target>-Tag hinzu:

• archiveNumbering="Date"
• archiveEvery="Day"
• archiveDateFormat="yyyy-MM-dd"
• archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"

• maxArchiveFiles="10"

  <?xml version="1.0" encoding="utf-8" ?>
  <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
    <rules>
      <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
    </rules>
    <targets>
      <target type="File"
        name="WorkflowLogFiles"
        fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log"
        layout="${time} ${level} ${message}"
        keepFileOpen="true"
        openFileCacheTimeout="5"
        concurrentWrites="true"
        encoding="utf-8"
        writeBom="true"
        archiveNumbering="Date"
        archiveEvery="Day"
        archiveDateFormat="yyyy-MM-dd"
        archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"
        maxArchiveFiles="10"
      />
    </targets>
  </nlog>

  Hinweis: maxArchiveFiles ist der Parameter, der die Anzahl der Archivdateien steuert.
  Hinweis: Für das Bearbeiten der Datei NLog.config benötigen Sie Administratorberechtigungen. Der Roboter muss nicht neu gestartet werden, damit die Änderungen wirksam werden.

Weitere Bearbeitung der Protokolle

Wenn die Protokollierungsstufe auf Verbose eingestellt ist, enthalten die Meldungen alle Details zu den 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\UiPath\Studio befindet, 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.

Nicht nur Aktivitätszustände lassen sich modifizieren, sondern auch Variablen und Argumente. Weitere Informationen über Anpassungsmöglichkeiten finden Sie hier.

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