Verwalten von Roboterprotokollen

Legen Sie die Roboterprotokollebenen im Assistant oder Orchestrator fest und konfigurieren Sie die Archivierung und Löschung von Protokolldateien mithilfe von NLog.config, um die Nutzung von Speicherplatz zu steuern.

Festlegen der Protokollierungsstufe

Sie können die Protokollebene ändern über:

• die Einstellung Protokollebene unter Assistant > Einstellungen > Seite Allgemein. Standardmäßig ist dies auf Information festgelegt. Für den Dienstmodusroboter benötigen Sie Administratorberechtigungen.
• die Einstellung Protokollierungsstufe unter Orchestrator > Zugriff verwalten > Benutzer > „Benutzer- oder Roboterkonto“ > Seite Robotereinstellungen. Standardmäßig ist dies auf Information festgelegt.
  Hinweis:

  Die Protokollstufe, die Sie im Orchestrator festgelegt haben, überschreibt die im Assistant konfigurierte Stufe.

Löschen von Protokolldateien

Wichtig:

Starting with Robot version 2025.10.1, the Robot keeps the 30 most recent daily execution log files and deletes older ones.

Um die Nutzung von Speicherplatz zu verhindern, können Sie Protokolldateien archivieren, sobald eine bestimmte Anzahl erreicht ist. Konfigurieren Sie Ihre Protokollierungsdateien in der Datei NLog.config im Abschnitt <target> wie folgt:

• Durch Hinzufügen der Eigenschaften archiveNumbering="Date" und archiveEvery="Day" weisen Sie das System an, Protokolldateien täglich zu archivieren, wobei jedes Archiv nach dem Datum benannt ist.
• Die Eigenschaft archiveDateFormat="yyyy-MM-dd" legt das Format für die Datumsangaben in den Archivdateinamen fest.
• Mit archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log" geben Sie den Speicherort und das Format für die archivierten Dateinamen an.
• Mit der Eigenschaft maxArchiveFiles="30" wird ein Grenzwert festgelegt, sodass nur die 30 letzten archivierten Protokolldateien gespeichert werden.

Hinweis:

A Robot update resets the NLog.config file, removing your edits. Apply them again after each update.

Zum Beispiel:

<?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="30"
    />
  </targets>
</nlog>

Anpassen detaillierter Protokolle

Verbose-level logs may contain extra information and can be large. For Windows - Legacy projects, you can control this by customizing the UiPath.Executor.exe.config file, in the net472 folder of the Robot installation folder. Windows and cross-platform projects don't read this file.

Wichtig:

A Robot update installs into a new versioned folder and copies only UiPath.config and NuGet.config to it, so your edits to UiPath.Executor.exe.config don't carry over. Apply them again after each update.

Add the following XML snippet under the <system.serviceModel> section, then restart the Robot Service:

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

Das <states>-Tag enthält Unter-Tags für jeden Status, den Sie protokollieren möchten. Wenn sie nur <state name="Faulted"/> enthält, werden nur Aktivitäten protokolliert, die im Status Fehlerhaft enden, d. h. bei denen ein Fehler aufgetreten ist.

Um andere Status einzuschließen, verwenden Sie <state name="Executing"/>.

Sie können auch Variablen und Argumente anpassen. Lesen Sie die Dokumentation von Microsoft.

Verwalten von Treiberdiagnoseprotokollen

Driver tracing records the UiPath drivers and the browser extension. For the command reference, refer to Robot Command Line Interface.

So aktivieren Sie die Treibernachverfolgung:

1. Öffnen Sie die Eingabeaufforderung mit Administratorrechten.
2. Access the Robot installation directory using the cd argument, such as cd "C:\Program Files\UiPathPlatform\Robot\<version>" for a per-machine installation, or cd "%LocalAppData%\Programs\UiPathPlatform\Robot\<version>" for a per-user installation.
3. Führen Sie den Befehl UiRobot.exe trace --enableLowLevel aus.

So deaktivieren Sie die Treiberablaufverfolgung:

1. Öffnen Sie die Eingabeaufforderung mit Administratorrechten.
2. Access the Robot installation directory using the cd argument, such as cd "C:\Program Files\UiPathPlatform\Robot\<version>" for a per-machine installation, or cd "%LocalAppData%\Programs\UiPathPlatform\Robot\<version>" for a per-user installation.
3. Führen Sie den Befehl UiRobot.exe trace --disableLowLevel aus.

The disable command saves the trace as UiPathTrace-<id>.etl on the Desktop of the user who runs the command.

Verwenden des Diagnosetools

Aktivieren Sie die Seite Über das Diagnosetool im Studio-Handbuch, um Informationen dazu zu erhalten, wie Sie es konfigurieren können, um Ausführungsprotokolle abzurufen.