Verwalten von Roboterprotokollen

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:

Ab der Robot-Version 2025.10.1 ist der Aufbewahrungszeitraum für Ausführungsprotokolle auf 30 Tage begrenzt.

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.

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

Protokolle auf der Ebene ausführlich können zusätzliche Informationen enthalten und groß sein.Sie können dies steuern, indem Sie die Datei UiPath.Executor.exe.configanpassen.Fügen Sie das folgende XML-Snippet unter dem <system.serviceModel>Abschnitt hinzu, und starten Sie dann den Robot Service neu:

<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

So aktivieren Sie die Treibernachverfolgung:

1. Öffnen Sie die Eingabeaufforderung mit Administratorrechten.
2. Greifen Sie mit dem Argument cd auf das Installationsverzeichnis zu, z. B. cd C:\Program Files\UiPath\Studio.
3. Führen Sie den Befehl UiRobot.exe --enableLowLevel aus.

So deaktivieren Sie die Treiberablaufverfolgung:

1. Öffnen Sie die Eingabeaufforderung mit Administratorrechten.
2. Greifen Sie mit dem Argument cd auf das Installationsverzeichnis zu, z. B. cd C:\Program Files\UiPath\Studio.
3. Führen Sie den Befehl UiRobot.exe --disableLowLevel aus.

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.