订阅

UiPath Insights

UiPath Insights 指南

Configuring Log Rules

概述


机器人日志可捕获诊断日志和执行日志。您可以配置 Insights 用于提取机器人日志的条件。例如,您只想捕获包含特定名称的流程的日志。

For more information, see Robot logs.

何时配置日志规则


默认日志规则


Insights 用于提取的机器人日志的默认设置包括“仅提取最新日志和错误日志”。以下部分显示的内容为您正在运行的 Insights 版本所用的默认日志规则。

版本 2022.4 的默认日志规则

在此示例中,系统会提取所有流程的最新日志和错误日志。此版本的 Insights 从已执行流程的机器人中提取最新的 Info 级别的日志,以及流程和 Error 级别的日志,如以下示例所示。

<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" />
  </filters>
</logger>

版本 2021.10 的默认日志规则

在此示例中,提取所有流程的所有日志(Info 级别及更高级别)。此版本的 Insights 会提取机器人为所有流程生成的所有日志(Info 级别及更高级别),如以下示例所示。

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

配置日志规则


📘

在开始之前

  • 只有管理员才能更改 Orchestrator 配置文件中的值。

  • 在继续之前备份 UiPath.Orchestrator.dll.config 文件。您可以在 C:\Program Files (x86)\UiPath\Orchestrator 中找到该文件。

  • 更改 Orchestrator 配置文件后重新启动网站。

  • 所有参数都区分大小写。

  • 为获得最佳性能,两年内生成的机器人日志不应超过 2 亿条记录。

  • 使用 NLog 配置文件在您的环境中捕获与 Insights 相关的数据,并减少机器人日志生成的记录数量。

  1. 导航到 C:\Program Files (x86)UiPath\Orchestrator,然后打开 UiPath.Orchestrator.dll.config 文件以修改 Orchestrator 设置。
  2. 查找“机器人日志”参数(例如 <logger name="Robot.*" environmentSpecificConfiguration/>
  3. 使用默认操作配置筛选条件(例如 filters defaultAction="Ignore")。
  4. 根据日志级别或其他事件配置条件(请参阅日志规则示例)。
  5. 保存文件并重新启动 Orchestrator。

For more information on configuring the Orchestrator configuration file, see UiPath.Orchestrator.dll.config.

日志规则示例


以下示例显示了 Info 和 Error 级别日志的自定义日志规则配置。通过设置特定条件,Insights 将仅针对您配置的流程提取日志。

提取特定流程的所有日志和任何错误日志

在以下示例中,Insights 会针对下列流程,提取所有 Info 级别和 Error 级别的日志:payment disp68fields68fields_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>

仅提取特定流程的最新日志和错误日志

在以下示例中,Insights 仅会针对下列流程,提取最新的 Info 级别日志和 Error 级别日志:payment disp68fields68fields_20

系统仅会将每个机器人的 Error 级别的日志和最新日志记录到 Insights。

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

不要提取特定流程的日志


在以下示例中,Insights 不会为名为 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>

相关文章


NLog configuration file

约一个月前更新


Configuring Log Rules


建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。