- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 对象存储库
- ScreenScrapeJavaSupport 工具
- 扩展程序
- Studio 测试
- 故障排除
Studio 用户指南
日志记录级别
下表列出了 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 日志页面 |
|---|---|---|---|---|---|
| 详情 | Activities (活动) | `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 | 是 | 否 | 是 |
| 追踪 | Activities (活动) | `Trace {"message":{"DisplayName":"Main","State":"Executing","Activity":"System.Activities.DynamicActivity | 是 | 否 | 是 |
| 信息 | 写入行 日志消息 |
注意：不包括在活动中设置为“Trace”级别的日志消息。 | 是 | 是 | 是 |
| Warning | 警告 |
| 是 | 是 | 是 |
| Warning | 错误 |
| 是 | 是 | 是 |
| Warning | 重要事项 | 严重错误 | 是 | 是 | 是 |
| 错误 | 错误 |
| 是 | 是 | 是 |
| 错误 | 重要事项 重大的 | 严重错误 | 是 | 是 | 是 |
| 重要事项 | 重要事项 重大的 | 严重错误 | 是 | 是 | 是 |
| 关闭 | 不适用 | 不适用 | 否 | 否 | 否 |
日志消息类型
根据所记录的事件，日志消息可能会出现如下所示的几种情况：
默认日志
以下情形中默认生成的日志：项目执行启动和结束，出现系统错误且执行停止，或者将日志记录设置配置为记录每个活动的执行。
在这些日志中，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字段。
特定于类型的字段
这些日志会按日志类型显示：
- 执行结束
totalExecutionTimeInSecondstotalExecutionTime
- 事务开始
queueNametransactionIDtransactionState
- 事务结束
queueNametransactionIDtransactionStatetransactionStatustransactionExecutionTimeprocessingExceptionTypeprocessingExceptionReasonqueueItemReviewStatusqueueItemPriority
- 调试日志
activityInfo，表示包含以下字段的 JSON 消息：DisplayNameState（“出错”、“已关闭”、“正在执行”）ActivityVariablesArguments
只有 totalExecutionTimeInSeconds、totalExecutionTime 和 queueName 会一直出现在日志消息中。Variables 和 Arguments 通常有子字段。
用户定义的字段
通过使用“添加日志字段”活动，您即可在 Studio 中定义这些字段；除非通过“删除日志字段”活动将其删除，否则在生成活动后，所有后续日志中均会出现这些字段。
如果创建的用户定义日志字段与默认的日志字段具有相同的名称，这会导致登录流程受损，并可使您在运行的工作流中出现问题。 例如，创建名为 jobId 的用户定义的日志字段会导致此问题，因为 jobId 是默认情况下生成的日志字段。