- Versionshinweise
- Erste Schritte
- Zugriff und Berechtigungen
- Installation und Upgrade
- Interaktion mit Insights
- Export historischer Daten
- Protokolle
- Konfigurieren von Protokollregeln
- Protokollsammlung
- Leistung und Skalierbarkeit
Konfigurieren von Protokollregeln
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.
- Nach der Insights-Installation.
- Nach dem Insights-Upgrade.
- Wenn Sie vorhandene Protokollregeln hinzufügen oder konfigurieren möchten.
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.
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 >= LogLevel.Error or ends-with('${message}',' execution ended')" action="Log" />
<when condition="'${ui-robot-logs-num-custom-fields}' > 1 and not ends-with('${message}', ' execution started')" action="Log" />
</filters>
<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')" action="Log" />
<when condition="'${ui-robot-logs-num-custom-fields}' > 1 and not ends-with('${message}', ' execution started')" action="Log" />
</filters>
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"/>
<logger name="Robot.*" ruleName="insightsRobotLogsRule" enabled="true" minlevel="Info" writeTo="insightsRobotLogs"/>
- 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 unterC:\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.
- Navigieren Sie zu C:\Programme (x86)\UiPath\Orchestrator und öffnen Sie die Datei
UiPath.Orchestrator.dll.config
, um Orchestrator-Einstellungen zu ändern. - Suchen Sie die Parameter der Roboterprotokolle (z. B.
<logger name="Robot.*" environmentSpecificConfiguration/>
) - Konfigurieren Sie einen Filter mit einer Standardaktion (z. B.
filters defaultAction="Ignore"
). - Konfigurieren Sie Bedingungen basierend auf der Protokollebene oder anderen Ereignissen (siehe Beispiel für Protokollregeln).
- Speichern Sie die Datei, und starten Sie den Orchestrator neu.
Weitere Informationen zum Konfigurieren der Orchestrator-Konfigurationsdatei finden Sie unter UiPath.Orchestrator.dll.config.
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.
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>
<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>
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>
<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>
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>
<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>
- Überblick
- Wann Protokollregeln konfiguriert werden sollten
- Standardprotokollregeln
- Standardprotokollregeln für Versionen 2022.4 und höher
- Standardprotokollregeln für Version 2021.10
- Protokollregeln konfigurieren
- Beispiele für Protokollregeln
- Erfassen aller Protokolle und aller Fehlerprotokolle für einen bestimmten Prozess
- Nur letzte Protokolle und Fehlerprotokolle für einen bestimmten Prozess erfassen
- Keine Protokolle für einen bestimmten Prozess erfassen
- Ähnliche Artikel