Konfigurieren von Protokollregeln

Überblick

Roboterprotokolle erfassen Diagnose- und Ausführungsprotokolle. Sie können die Bedingungen konfigurieren, für die Roboterprotokolle von Insights aufgenommen werden. Beispielsweise möchten Sie nur Protokolle für Prozesse erfassen, die einen bestimmten Namen enthalten.

Weitere Informationen finden Sie unter Roboterprotokolle.

Wann Protokollregeln konfiguriert werden sollten

• Nach der Insights-Installation.
• Nach dem Insights-Upgrade.
• Wenn Sie vorhandene Protokollregeln hinzufügen oder konfigurieren möchten.

Standardprotokollregeln

Die Standardeinstellungen für Roboterprotokolle, die von Insights erfasst werden, enthalten nur die letzten Protokolle und Fehlerprotokolle. Die folgenden Abschnitte zeigen Standardprotokollregeln basierend auf der Insights Version, die Sie ausführen.

Standardprotokollregeln für Version 2022.4 und höher

In diesem Beispiel werden die letzten Protokolle und Fehlerprotokolle für alle Prozesse erfasst. Diese Version von Insights erfasst die letzte Info-Ebene eines Roboters, der einen Prozess ausgeführt hat, neben dem Prozess und allen Protokollen der Error-Ebene, wie im folgenden Beispiel gezeigt.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
        <filters defaultAction="Ignore">
          <when condition="level &gt;= LogLevel.Error or ends-with('${message}',' execution ended')" action="Log" />
          <when condition="'${ui-robot-logs-num-custom-fields}' &gt; 1 and not ends-with('${message}', ' execution started')" action="Log" />
        </filters>

Standardprotokollregeln für Version 2021.10

In diesem Beispiel werden alle Protokolle (ab Info-Ebene) für alle Prozesse erfasst. Diese Version von Insights erfasst alle Protokolle (ab Info-Ebene), die vom Roboter für alle Prozesse generiert wurden, wie im folgenden Beispiel gezeigt.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs"/>

Protokollregeln konfigurieren

Hinweis:

• Nur Administratoren sollten die Werte in der Orchestrator-Konfigurationsdatei ändern.
• Sichern Sie die Datei UiPath.Orchestrator.dll.config, bevor Sie fortfahren. Sie finden die Datei unter C:\Program Files (x86)\UiPath\Orchestrator.
• Starten Sie die Website neu, nachdem Sie Änderungen an der Orchestrator-Konfigurationsdatei vorgenommen haben.
• Bei allen Parametern wird die Groß-/Kleinschreibung berücksichtigt.
• Für die beste Leistung sollten Roboterprotokolle, die über einen Zeitraum von zwei Jahren generiert werden, 200 Millionen Datensätze nicht überschreiten.
• Verwenden Sie die NLog-Konfigurationsdatei, um Daten zu erfassen, die für Insights in Ihrer Umgebung relevant sind, und um die Anzahl der von Roboterprotokollen generierten Datensätze zu reduzieren.

1. Navigieren Sie zu C:\Programme (x86)\UiPath\Orchestrator und öffnen Sie die Datei UiPath.Orchestrator.dll.config, um Orchestrator-Einstellungen zu ändern.
2. Suchen Sie die Parameter der Roboterprotokolle (z. B. <logger name="Robot.*" environmentSpecificConfiguration/>)
3. Konfigurieren Sie einen Filter mit einer Standardaktion (z. B. filters defaultAction="Ignore").
4. Konfigurieren Sie Bedingungen basierend auf der Protokollebene oder anderen Ereignissen (siehe Beispiel für Protokollregeln).
5. Speichern Sie die Datei, und starten Sie den Orchestrator neu.

Weitere Informationen zum Konfigurieren der Orchestrator-Konfigurationsdatei finden Sie unter UiPath.Orchestrator.dll.config.

Beispiele für Protokollregeln

Die folgenden Beispiele zeigen benutzerdefinierte Protokollregelkonfigurationen für Protokolle der Ebenen Info und Error. Durch Festlegen bestimmter Bedingungen erfasst Insights nur Protokolle für die von Ihnen konfigurierten Prozesse.

{
  "10_Robot_Insights": {
    "enabled": false,
    "final": false,
    "logger": "Robot.*",
    "minLevel": "Info",
    "ruleName": "insightsRobotLogsRule",
    "writeTo": "insightsRobotLogs"
  }
}

Erfassen aller Protokolle und aller Fehlerprotokolle für einen bestimmten Prozess

Im folgenden Beispiel erfasst Insights alle Protokolle der Ebenen Info und Error für die folgenden Prozessnamen: payment disp, 68fields oder 68fields_20.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
    <filters defaultAction="Ignore">
      <when condition="equals('${event-properties:item=processName}', 'payment disp') or equals('${event-properties:item=processName}', '68fields') or equals('${event-properties:item=processName}', '68fields_20')" action="Log" />
    </filters>
  </logger>

Nur letzte Protokolle und Fehlerprotokolle für einen bestimmten Prozess erfassen

Im folgenden Beispiel erfasst Insights nur die letzten Protokolle der Ebenen Info und Error für die folgenden Prozessnamen: payment disp, 68fields oder 68fields_20.

Nur Protokolle der Ebene Error und das letzte Protokoll eines jeden Roboters werden bei Insights protokolliert.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
    <filters defaultAction="Ignore">
      <when condition="(level >= LogLevel.Error or ends-with('${message}',' execution ended')) and (contains('${event-properties:item=processName}', 'payment disp') or equals('${event-properties:item=processName}', '68fields') or equals('${event-properties:item=processName}', '68fields_20'))" action="Log" />
    </filters>
  </logger>

Keine Protokolle für einen bestimmten Prozess erfassen

Im folgenden Beispiel erfasst Insights keine Protokolle für den Prozessnamen: payment disp.

<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs">
    <filters defaultAction="Log">
      <when condition="equals('${event-properties:item=processName}', 'payment disp')" action="Ignore" />
    </filters>
  </logger>

Ähnliche Artikel

NLog-Konfigurationsdatei