机器人日志

日志是带有时间戳的文件，其中包含与应用程序相关的信息事件、错误和警告消息。

如果 Orchestrator 处于不可用状态，则在连接恢复前，系统会将日志存储在可用磁盘空间的本地数据库 (C:\Windows\SysWOW64\config\systemprofile\AppData\Local\UiPath\Logs\execution_log_data) 中。恢复连接后，系统会按日志的生成顺序将其分批发送。

备注：

将日志成功发送至 Orchestrator 后，系统不会删除此数据库。

作业状态存储在 UiPath 机器人服务的内存中。如果 Orchestrator 处于可用状态，则系统会在二者之间同步作业状态的相关信息。不过，如果 Orchestrator 处于不可用状态，则您在重启 UiPath 机器人服务后便会丢失此类信息。这意味着，每当 Orchestrator 处于可用状态时，您均需再次执行作业。

机器人诊断日志

此类日志提供与机器人自身及其环境相关的信息。这些信息可用于确定特定错误的原因。

启用机器人诊断日志

默认情况下，系统会启用机器人诊断日志，并记录“Error”或“Warning”级别的所有消息。

如果需要其他级别的日志记录信息，可通过启用“低级别追踪”来启用这些级别的日志记录。系统默认会禁用此功能。

要启用“低级别追踪”，请在“命令提示符”中运行以下命令 UiRobot.exe --enableLowLevel。

要启用“低级别追踪”，请在“命令提示符”中运行以下命令：UiRobot.exe --disableLowLevel。

以管理员、本地用户或域用户身份启用“低级别追踪”后，即可为 .etl 文件启用低级别追踪。这样便可在“事件查看器”中为机器人执行程序和服务启用 Verbose 追踪功能。

切记首先使用 cd 参数（例如 cd C:\Program Files (x86)\UiPath\Studio）转到安装目录。

备注：

我们建议仅在调查问题时启用“低级别追踪”，并在调查会话结束后将其禁用。

此外，仅在禁用该功能后，才会生成包含追踪信息的 .etl 文件。

无需重新启动机器人即可使更改生效。

机器人诊断日志的目标

日志的目标位置由<Installation Folder>\NLog.config文件控制。诊断日志由内部类型记录器收集，并使用 NLog 目标进行转发。

By default, Internal logs are sent to Event Viewer, as specified in the following lines from NLog.config:

<target xsi:type="EventLog" name="eventLog" layout="${callsite:className=false:includeSourcePath=true:methodName=false} ${message}" source="UiPath" log="Application" />
<logger name="Internal" minLevel="Trace" writeTo="eventLog" />

备注：

编辑 NLog.config 文件需要管理员权限。如果已更改 NLog.config 文件中的“内部”目标，则需通过重启“UiRobot.exe”服务使更改生效。

打开 .etl 日志文件

您可通过事件查看器打开此类文件：

1. 在事件查看器的“操作”面板中，单击“打开保存的日志”。系统会显示“打开保存的日志”窗口。

2. 浏览生成的 Trace 日志文件，然后单击“打开”。左侧面板的“保存的日志”下方将显示该文件。

3. 选择该文件。请注意，系统会显示日志内容。

   

机器人执行日志

机器人执行日志是执行流程后生成的消息，通常包含与其行为和用户定义的消息相关的信息。

有多种方法可生成执行日志：

• “写入行”活动会创建“Trace”级别的日志。
• “日志消息”活动会根据“级别”属性字段中指定的级别创建日志。
• 执行自动化项目将生成包含每个活动的行为的日志。如果将“Orchestrator 设置”窗口中的“级别”设置设为“Verbose”，则这些日志将属于“Trace”级别。

执行日志的日志记录级别

默认的日志记录级别由“Orchestrator 设置”窗口中的“级别”设置控制。该设置默认为“Information”。

更改“Orchestrator 设置”窗口中的默认日志记录级别：

1. 在 UiPath Assistant 中，转到“首选项”菜单，然后访问“Orchestrator 设置”

2. 在“日志记录”部分的“日志级别”下拉菜单中，选择所需的日志记录级别。

   

   备注：

   如将机器人作为 Windows 服务进行安装，则需要管理员权限才能编辑此设置。

执行日志的目标

By default, Execution Logs are stored in a file in the %LocalAppData%\UiPath\Logs folder. The messages are collected by the Execution type logger and can be forwarded by using NLog targets, as specified by the following parameters in the NLog.config file:

<target xsi:type="File" name="executionFile" fileName="${LogDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" concurrentWrites="true" />
<logger name="Execution" minLevel="Trace" writeTo="executionFile" final="true" />

If the Robot is connected to Orchestrator, all execution logs are sent to Orchestrator and can be seen in the Logs page.

另外，可以通过编辑 <Installation Folder>\NLog.config 文件来配置日志目标和内容。

备注：

编辑 NLog.config 文件需要管理员权限。无需重启机器人服务即可使更改生效。

深入编辑日志

如果将日志记录级别设为“Verbose”，则消息将包含执行期间运行的活动的所有详细信息。您可通过编辑 UiPath.Executor.exe.config 文件（位于 C:\Program Files (x86)\UiPath\Studio 文件夹中）自定义此类日志输出。为此，必须在 <system.serviceModel> 标签下添加 XML 代码。例如:

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

鉴于 <states> 标签仅包含 <state name="Faulted"/>，因此插入以上代码只能记录拥有“Faulted”（出错）状态的活动。在 <states> 标签下添加其他参数（例如 <state name="Executing"/>）也会记录拥有其他状态的活动。

Not only activity states can be modified, but also other things, such as variables and arguments. More information about customization can be found here.

备注：

修改 UiPath.Executor.exe.config 文件后，您需通过重启机器人服务使更改生效。

刷新尺寸和刷新间隔

The Flush Size and Flush Interval can be changed from the Orchestrator UiPath.Orchestrator.dll.config settings. See the UiPath.Orchestrator.dll.config document for more details.

备注：

将日志发送到 Orchestrator 的命令在为 RobotsLogs.Flush.Interval 设置的时间间隔结束时触发。如果在这段时间结束之前累积了日志并且机器人断开了连接，则这些日志将在下一次机器人连接到 Orchestrator 时发送。