robot
2020.10
false
重要 :
请注意此内容已使用机器翻译进行了部分本地化。
不在支持范围内
机器人用户指南
Last updated 2024年7月1日

机器人日志

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

如果 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 目标即可转发该类日志。
默认情况下,系统会将内部日志发送至“事件查看器”,如下方 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" /><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 文件夹的某个文件中。“执行”类型记录器会收集执行日志,并且通过使用 NLog 目标即可转发该类日志,如下方 NLog.config 文件中的参数所示:
<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" /><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" />

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

另外,可以通过编辑 <Installation Folder>\NLog.config 文件来配置日志目标和内容。
注意:编辑 NLog.config 文件需要管理员权限。无需重新启动机器人服务即可使更改生效。

深入编辑日志

如果日志记录级别设置为 Verbose,则消息将包含有关在执行时运行的活动的所有详细信息。可以通过编辑 C:\Program Files (x86)\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><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 文件后,您需通过重启机器人服务使更改生效。

刷新尺寸和刷新间隔

刷新大小和刷新间隔可以通过 Orchestrator UiPath.Orchestrator.dll.config 设置更改。有关详细信息,请参阅 UiPath.Orchestrator.dll.config 文档。
注意:将日志发送到 Orchestrator 的命令会在为 RobotsLogs.Flush.Interval 设置的时间间隔结束时触发。如果在这段时间结束之前累积了日志并且 Robot 断开了连接,则这些日志将在下一次 Robot 连接到 Orchestrator 时发送。

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。