订阅

UiPath Studio

UiPath Studio 指南

日志记录级别

UiPath 中的日志记录级别

Logging Level

Default Logs

User-Defined Logs

Off

None

None

Critical

All messages logged with Critical level or higher.

All messages logged with Critical level or higher.

Error

All messages logged with Error level or higher.

All messages logged with Error level or higher.

Warning

All messages logged with Warning or higher.

All messages logged with Warning or higher.

Information

All messages logged with Information or higher.

All messages logged with Information or higher.

Trace

All messages logged with Trace level or higher.

All messages logged with Trace level or higher.

Verbose

All messages logged with Trace level and Workflow Tracking logs.

All messages logged with Trace level.

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

默认情况下,“Verbose”级别包括:

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

📘

备注:

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

Log Level

Logged

Example / Comment

Log File

Output Panel

Orchestrator Log page

Verbose

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

Yes

No

Yes

Verbose

Variables

"Variables":{"NewTransaction":"False"}}

Yes

No

Yes

Verbose

Arguments (properties)

"Arguments":{"Caption":"","Text":"String in message BOX","ChosenButton":"Ok"}

Yes

No

Yes

Trace

Activities

Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity"}
Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.Statements.Flowchart"}

Yes

No

Yes

Information

WriteLine
Log Message

Info {"message":"message from activity"
Note: Except messages logged with Trace level set in activity.

Yes

Yes

Yes

Warning

Warnings

Warn {"message":"Warning from log message activity"

Yes

Yes

Yes

Warning

Errors

Error {"message":"Error from log message activity"

Yes

Yes

Yes

Warning

Critical

Critical Errors

Yes

Yes

Yes

Error

Errors

Error {"message":"Error from log message activity"

Yes

Yes

Yes

Error

Critical
Fatal

Critical Errors

Yes

Yes

Yes

Critical

Critical
Fatal

Critical Errors

Yes

Yes

Yes

OFF

n/a

n/a

No

No

No

日志消息类型

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

默认日志

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

📘

备注:

在这些日志中,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,则日志中不会出现 processNameprocessVersion 字段。

特定于类型的字段

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

执行结束

  • totalExecutionTimeInSeconds
  • totalExecutionTime

事务开始

  • queueName
  • transactionID
  • transactionState

事务结束

  • queueName
  • transactionID
  • transactionState
  • transactionStatus
  • transactionExecutionTime
  • processingExceptionType
  • processingExceptionReason
  • queueItemReviewStatus
  • queueItemPriority

调试日志

  • activityInfo,表示包含以下字段的 JSON 消息:
    • DisplayName
    • State(“出错”、“已关闭”、“正在执行”)
    • Activity
    • Variables
    • Arguments

📘

备注:

只有 totalExecutionTimeInSecondstotalExecutionTimequeueName 会一直出现在日志消息中。VariablesArguments 通常有子字段。

用户定义的字段

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

📘

重要

如果创建的用户定义日志字段与默认的日志字段具有相同的名称,这会导致登录流程受损,并可使您在运行的工作流中出现问题。
例如,创建名为 jobId 的用户定义的日志字段会导致此问题,因为 jobId 是默认情况下生成的日志字段。

大约一年前更新

日志记录级别


建议的编辑仅限用于 API 参考页面

您只能建议对 Markdown 正文内容进行编辑,而不能建议对 API 规范进行编辑。