日志记录级别

下表列出了 UiPath 中的日志记录级别。

日志记录级别	默认日志	用户定义的日志
关闭	无	无
重要事项	所有“Critical”或更高级别的日志记录消息。	所有“Critical”或更高级别的日志记录消息。
错误	所有“Error”或更高级别的日志记录消息。	所有“Error”或更高级别的日志记录消息。
Warning	所有“Warning”或更高级别的日志记录消息。	所有“Warning”或更高级别的日志记录消息。
信息	所有“Information”或更高级别的日志记录消息。	所有“Information”或更高级别的日志记录消息。
追踪	所有“Trace”或更高级别的日志记录消息。	所有“Trace”或更高级别的日志记录消息。
详情	所有“Trace”级别和工作流追踪日志的记录消息。	以 Trace 级别记录的所有消息。

“Verbose”级别记录“开始”和“结束”活动的消息，以及所使用的变量和参数值。

默认情况下，“Verbose”级别包括：

• “执行已开始”日志条目 - 每当启动流程时生成此条目。
• “执行已结束”日志条目 - 每当完成流程时生成此条目。
• “事务已开始”日志条目 - 每当机器人从 Orchestrator 中获取事务项目时生成此条目。
• “事务已结束”日志条目 - 每当机器人将事务状态设置为“成功”或“失败”时生成此条目。

• “活动信息”日志条目 - 每当工作流中的活动“启动”、“出错”或“结束”时生成此条目。

  注意：日志类型的优先级顺序为：Verbose < Trace < Information < Warning < Error < Critical < Off。

  日志级别	日志内容	示例/注释	日志文件	输出面板	Orchestrator 日志页面
  详情	活动	`Trace {"message":{"DisplayName":"Message box","State":"Executing","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":{"Caption":"","Text":"String in message BOX	是	否	是
  详情	变量	`"Variables":{"NewTransaction":"False	是	否	是
  详情	参数（属性）	`"Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok	是	否	是
  追踪	活动	`Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity	是	否	是
  信息	写入行 日志消息	Info {"message":"message from activity" 注意：不包括在活动中设置为“Trace”级别的日志消息。	是	是	是
  Warning	警告	Warn {"message":"Warning from log message activity"	是	是	是
  Warning	错误	Error {"message":"Error from log message activity"	是	是	是
  Warning	重要事项	严重错误	是	是	是
  错误	错误	Error {"message":"Error from log message activity"	是	是	是
  错误	重要事项 重大的	严重错误	是	是	是
  重要事项	重要事项 重大的	严重错误	是	是	是
  关闭	不适用	不适用	否	否	否

日志消息类型

根据所记录的事件，日志消息可能会出现如下所示的几种情况：

默认日志

以下情形中默认生成的日志：项目执行启动和结束，出现系统错误且执行停止，或者将日志记录设置配置为记录每个活动的执行。

注意：在这些日志中，logType 字段的值为 Default。

此类别记录的事件包括：

• “执行开始”（每当启动流程时生成此事件）。从“Information”日志记录级别开始记录此事件。
• “执行结束”（每当完成流程时生成此事件）。从“Information”日志记录级别开始记录此事件。
• “事务开始”（每当启动流程中的事务时生成此事件）。从“Information”日志记录级别开始记录此事件。
• “事务结束”（每当完成流程中的事务时生成此事件）。从“Information”日志记录级别开始记录此事件。
• 错误日志（每当执行遇到错误并停止时生成此事件）。从“Error”日志记录级别开始记录此事件。
• 每当将“机器人日志记录设置”设为“Verbose”并包含活动名称、类型、变量值、参数等时，“调试日志”即会生成。从“Trace”日志记录级别开始记录此事件。

用户定义的日志

当使用“日志消息”活动或“写入行”活动时，依据 Studio 中用户设计的流程生成的日志。

注意：在这些日志中，logType 字段的值为 User。

如果以小于 1 毫秒的间隔生成此类日志，则其可能不会在“输出”面板中正确显示。

日志字段

上述日志消息类型中包含多种类型的日志字段。具体可分成以下几类：

默认字段

所有执行类型日志中均会出现这些日志字段，其中包括 SQL（如有此配置）、Elasticsearch（如有此配置）和默认的事件查看器日志：

• Message - 日志消息。
• Level - 定义日志的严重级别。
• Timestamp - 执行操作的确切日期和时间。
• FileName - 正在执行的 .xaml 文件的名称。
• jobId - 运行流程的作业的键。
• processName - 触发日志记录的流程的名称。
• processVersion - 流程的版本号。
• windowsIdentity - 执行了所记录操作的用户的名称。
• robotName - 机器人的名称（如 Orchestrator 中的定义所示）。
  注意：如果您在本地运行流程，且未连接到 Orchestrator，则日志中不会出现 processName 和 processVersion 字段。

特定于类型的字段

这些日志会按日志类型显示：

• 执行结束

  • 总执行时间（秒）
  • 总执行时间

• 事务开始

  • 队列名称
  • 交易 ID
  • 交易说明

• 事务结束

  • 队列名称
  • 交易 ID
  • 交易说明
  • 交易状态
  • 事务执行时间
  • 处理异常的类型
  • 处理异常的原因
  • 队列项目审核状态
  • 队列项目优先级

• 调试日志

  • activityInfo，表示包含以下字段的 JSON 消息：
    • 显示名称
    • State（“出错”、“已关闭”、“正在执行”）
    • 活动
    • 变量

    • Arguments

注意：只有 totalExecutionTimeInSeconds、totalExecutionTime 和 queueName 会一直出现在日志消息中。Variables 和 Arguments 通常具有子字段。

用户定义的字段

通过使用“添加日志字段”活动，您即可在 Studio 中定义这些字段；除非通过“删除日志字段”活动将其删除，否则在生成活动后，所有后续日志中均会出现这些字段。

备注：

如果创建的用户定义日志字段与默认的日志字段具有相同的名称，这会导致登录流程受损，并可使您在运行的工作流中出现问题。

例如，创建名为 jobId 的用户定义的日志字段会导致此问题，因为 jobId 是默认情况下生成的日志字段。