日志记录和日志级别

在执行流程的过程中，机器人会为整个过程的每一个步骤生成一则消息（日志）。这些消息会收集并存储在日志文件中。收集和存储日志的整体操作即称为日志记录。

每个日志都有日志级别，表示所生成消息的详细程度。

日志级别是指写入日志文件的严重性类型。

UiPath 中的日志记录级别

日志级别	日志内容	示例/注释	日志文件	输出面板	Orchestrator 日志页面
详情	Activities (活动)	Trace {"message":{"DisplayName":"Message box","State":"Executing","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":{"Caption":"","Text":"String in message BOX"}... Trace {"message":{"DisplayName":"Message box","State":"Closed","Activity":"UiPath.Dialog.Activities.MessageBox","Arguments":``{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}	是	否	是
详情	变量	"Variables":{"NewTransaction":"False"}}	是	否	是
详情	参数（属性）	"Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}	是	否	是
追踪	Activities (活动)	Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"} Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.Statements.Flowchart"} Note: These logs are part of the Workflow Tracking logs and can only be seen using Verbose level.	是	否	是
追踪	写入行	Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"} Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.Statements.Flowchart"}	是	是	是
信息	日志消息	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"	是	是	是
错误	重要事项 重大的	严重错误	是	是	是
重要事项	重要事项 重大的	严重错误	是	是	是
关闭	不适用	不适用	否	否	否

UiPath 中的日志记录级别

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

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

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

• “执行已开始”日志条目 - 每当启动流程时生成此条目。

• “执行已结束”日志条目 - 每当完成流程时生成此条目。

• “事务已开始”日志条目 - 每当机器人从 Orchestrator 中获取事务项目时生成此条目。

• “事务已结束”日志条目 - 每当机器人将事务状态设置为“成功”或“失败”时生成此条目。

• Activity Information log entry - generated every time an activity is started,faulted or finished inside a process.

  备注：

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

日志类型：

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

默认

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

备注：

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

此类别记录的事件包括：

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

用户定义

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

备注：

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

日志字段

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

默认字段

• 消息：日志消息。

• 级别：定义日志严重性。

• 时间戳记：执行操作的确切日期和时间。

• “文件名”- 正在执行的 .xaml 文件的名称。

• 作业 ID：运行流程的作业的键。

• 流程名称：触发日志记录的流程的名称。

• 流程版本：流程的版本号。

• 窗口身份：执行所记录操作的用户的名称。

• “机器人名称”：机器人的名称（在 Orchestrator 中定义）

  备注：

  如果您在本地运行流程，且未连接到 Orchestrator，则日志中不会出现 processName 和 processVersion 字段。

特定于类型的字段

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

执行结束

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

事务开始

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

事务结束

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

调试日志

activityInfo，表示包含以下字段的 JSON 消息：

• 显示名称
• “状态”（故障、已关闭、正在执行）
• 活动
• 参数

备注：

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

用户定义的字段

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

备注：

定义“自定义日志字段”时，请确保还要根据“默认日志字段”检查命名，以避免“日志文件”与同一“日志字段”或损坏的日志文件之间存在冲突信息。“自定义”日志字段和“默认”日志字段具有相同的命名约定也会影响正在执行的流程。