Roboter-Protokolle

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

Die Protokolltypen werden auf den folgenden Seiten vorgestellt:

Roboter-Ausführungsprotokolle

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

Ausführungsprotokolle werden generiert von:

• Die Aktivität Write Line erstellt Protokolle auf der Stufe „Trace“.
• Aktivität Log Message, die Protokolle auf der Stufe erstellt, die im Eigenschaftsfeld Stufe der Aktivität angegeben ist.
• Beim Ausführen eines Automatisierungsprojekts werden Protokolle erstellt, die das Verhalten jeder Aktivität beinhalten. Diese Protokolle verwenden die Stufe Trace, wenn die Einstellung Stufe im Fenster „Orchestrator-Einstellungen“ 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.

Hinweis: Die in Orchestrator festgelegte Protokollstufe für den Roboter überschreibt die im UiPath^® Assistant festgelegte.

Nur Protokolle, die der in den Assistant- oder Orchestrator-Einstellungen angegebenen Ebene entsprechen, werden an den Orchestrator gesendet.

Ändern der Standardprotokollierungsstufe in UiPath Assistant:

1. Öffnen Sie im 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 im Dienstmodus installiert ist, sind Administratorrechte erforderlich, um diese Einstellung zu bearbeiten.

Orchestrator-Ziel

Wenn der Roboter mit dem Orchestrator verbunden ist, werden auf der Seite Protokolle nur Protokolle angezeigt, die der im Assistant oder im Orchestrator festgelegten Ebene entsprechen.

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.

NLog-Ziel

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

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

Löschen alter Workflow-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 in der NLog.config 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 der folgende XML-Code unter dem Tag <system.serviceModel> hinzugefügt werden.

<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.

Roboter-Diagnoseprotokolle

Die Roboter-Diagnoseprotokolle liefern Informationen in Bezug auf den Roboter selbst und dessen Kontext. Sie sind nützlich für die Identifizierung der Ursache eines bestimmten Fehlers.

Roboterdiagnoseprotokolle werden an den folgenden Orten gespeichert:

• Unter Windows werden Diagnoseprotokolle im Zusammenhang mit Fehlern in der Ereignisanzeige protokolliert.

• Auf allen Plattformen, einschließlich Windows, werden ausführliche Diagnoseprotokolle in eine Datei geschrieben:

  • %LocalAppData%\UiPath\Logs\internal\Robot.log unter Windows, wenn der Roboter im Benutzermodus installiert ist.
  • %PROGRAMDATA%\UiPath\Logs\internal\Robot.log unter Windows, wenn der Roboter im Dienstmodus installiert ist.
  • ~/.local/share/UiPath/Logs/internal/Robot.log auf anderen Plattformen.

Treiberdiagnoseprotokolle

Die Treiberablaufverfolgung wird in eine .etl-Datei geschrieben.

Um die Treiberablaufverfolgung zu aktivieren, öffnen Sie die Eingabeaufforderung mit Administratorrechten, greifen Sie mit dem Argument cd auf das Installationsverzeichnis zu, z. B. cd C:\Program Files\UiPath\Studio, und führen Sie den Befehl UiRobot.exe --enableLowLevel aus.

Um die Treiberablaufverfolgung zu deaktivieren, öffnen Sie die Eingabeaufforderung mit Administratorrechten, greifen Sie mit dem Argument cd auf das Installationsverzeichnis zu, z. B. cd C:\Program Files\UiPath\Studio, und führen Sie den Befehl UiRobot.exe --disableLowLevel aus.

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.