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

Sie können die Orchestrator-Einstellungen in der Datei nlog.custom.config konfigurieren. Führen Sie die folgenden Schritte aus, um die Einstellungen zu ändern:

1. Setzen Sie die neuen Protokollregeln in die Datei nlog.custom.config . Ein Beispiel finden Sie in den folgenden Details:

   {
     "10_Robot_Insights": {
       "logger": "Robot.*",
       "ruleName": "insightsRobotLogsRule",
       "minLevel": "Info",
       "writeTo": "insightsRobotLogs",
       "enabled": false,
       "final": false,
       "filters": {
         "defaultAction": "Ignore",
         "conditions": [
           {
             "condition": "level >= LogLevel.Error or ends-with('${message}', ' execution ended')",
             "action": "Log"
           }
         ]
       }
     }
   }

2. Verwenden Sie das Orchestrator-Konfiguratortool, um die Konfiguration zu aktualisieren. Verwenden Sie den folgenden Befehl, um die Schlüssel aus der benutzerdefinierten nlog.custom.config -Datei mit den Einstellungen zusammenzuführen, die bereits in der orchestrator-customconfig -Konfigurationsübersicht verfügbar sind.

    ./orchestrator-configurator.sh -l nlog.custom.config

   Dieser Befehl entfernt keine vorhandenen Einstellungen.

Beispiel für Protokollregeln

Im folgenden Beispiel senden wir nur Protokolle, die ein bestimmtes Level überschreiten oder die Meldung enthalten, dass die Ausführung beendet wurde:

{
  "10_Robot_Insights": {
    "logger": "Robot.*",
    "ruleName": "insightsRobotLogsRule",
    "minLevel": "Info",
    "writeTo": "insightsRobotLogs",
    "enabled": false,
    "final": false,
    "filters": {
      "defaultAction": "Ignore",
      "conditions": [
        {
          "condition": "level >= LogLevel.Error or ends-with('${message}', ' execution ended')",
          "action": "Log"
        }
      ]
    }
  }
}

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