机器人日志

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

如果 Orchestrator 处于不可用状态，则在连接恢复前，系统会将日志存储在可用磁盘空间的本地数据库 (C:\Windows\System32\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\UiPath\Studio）转到安装目录。

备注：

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

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

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

机器人诊断日志的目标

日志的目标位置由 <Installation Folder>\NLog.config 文件控制。“内部”类型记录器会收集诊断日志，并且通过使用 NLog 目标即可转发该类日志。

默认情况下，系统会将内部日志发送至“事件查看器”，如下方 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 服务进行安装，则需要管理员权限才能编辑此设置。

执行日志的目标

执行日志默认存储在 %LocalAppData%\UiPath\Logs 文件夹的某个文件中。“WorkflowLogging”记录器会收集消息，并且通过使用 NLog 目标即可转发该类日志，如下方 NLog.config 文件中的参数所示：

<?xml version="1.0" encoding="utf-8" ?>
<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
  <rules>
    <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
  </rules>
  <targets>
    <target type="File" name="WorkflowLogFiles" fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log" layout="${time} ${level} ${message}" keepFileOpen="true" openFileCacheTimeout="5" concurrentWrites="true" encoding="utf-8" writeBom="true" />
  </targets>
</nlog>

如果机器人已连接到 Orchestrator，则所有执行日志都将发送到 Orchestrator，并可以在“日志”页面中查看。

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

删除旧日志文件

为避免创建大量日志文件占用计算机上的磁盘空间，您可以选择在达到特定文件数量后存档日志文件。

为此，请在 <target> 标签中添加以下参数：

• archiveNumbering="Date"
• archiveEvery="Day"
• archiveDateFormat="yyyy-MM-dd"
• archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"

• maxArchiveFiles="10"

  <?xml version="1.0" encoding="utf-8" ?>
  <nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <variable name="WorkflowLoggingDirectory" value="${specialfolder:folder=LocalApplicationData}/UiPath/Logs" />
    <rules>
      <logger name="WorkflowLogging" writeTo="WorkflowLogFiles" final="true" />
    </rules>
    <targets>
      <target type="File"
        name="WorkflowLogFiles"
        fileName="${WorkflowLoggingDirectory}/${shortdate}_Execution.log"
        layout="${time} ${level} ${message}"
        keepFileOpen="true"
        openFileCacheTimeout="5"
        concurrentWrites="true"
        encoding="utf-8"
        writeBom="true"
        archiveNumbering="Date"
        archiveEvery="Day"
        archiveDateFormat="yyyy-MM-dd"
        archiveFileName="${WorkflowLoggingDirectory}/{#}_Execution.log"
        maxArchiveFiles="10"
      />
    </targets>
  </nlog>

  注意：maxArchiveFiles 是控制存档文件数量的参数。
  注意：编辑 NLog.config 文件需要管理员权限。无需重新启动机器人服务即可使更改生效。

深入编辑日志

如果日志记录级别设置为 Verbose，则消息将包含有关在执行时运行的活动的所有详细信息。可以通过编辑 C:\Program Files\UiPath\Studio 文件夹中的 UiPath.Executor.exe.config 文件来自定义此日志输出。为此，必须在 <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"/>）也会记录拥有其他状态的活动。

您不仅能修改活动状态，还可修改其他内容，例如变量和参数。如需详细了解自定义的相关信息，请参见此处。

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