标题6:UiPath 中的主要日志类型有哪些?
UiPath Platform 生成的主要日志类型:
Studio 日志。
设置日志。
Orchestrator 诊断日志。
机器人日志。
机器人日志
在执行流程的过程中,机器人会为整个过程的每一个步骤生成一则消息(日志)。系统会将这些消息收集并存储在日志文件中。收集和存储日志的整体操作即称为日志记录。
存在两种类型的机器人日志:
机器人执行日志:执行流程后生成的消息,通常包含与其行为和用户定义的消息相关的信息。
机器人诊断日志:提供与机器人本身及其上下文相关的信息。
发生某些事件时,系统会自动生成默认日志。此类别日志记录的事件包括:
- 执行开始时间,每次启动流程时生成(级别 = Information)。
- 执行结束时间,每次流程完成时生成(级别 = Information)。
- 事务开始,每次启动流程中的事务时生成(级别 = Information)。
- 事务结束,每次完成流程中的事务时生成(级别 = Information)。
- 错误日志,每次执行流程遇到错误并停止时生成(级别 = Error)。
- 调试日志,如果将“机器人日志记录设置”设为“Verbose”,并且“机器人日志记录设置”中包含活动名称、类型、变量值、参数等内容时生成(级别 = Trace)。
在使用“日志消息”活动或“写入行”活动时,系统会根据您在 Studio 中设计的流程生成用户定义的日志。
Verbose 级别日志
Verbose 级别日志记录“开始”和“结束”活动的消息,以及所使用的变量和参数的值。Verbose 级别用于调试。
默认情况下,Verbose 级别包括以下内容:
“执行已开始”日志条目 - 每当启动流程时生成此条目。
“执行已结束”日志条目 - 每当完成流程时生成此条目。
“事务已开始”日志条目 - 每当机器人从 Orchestrator 中获取事务项目时生成此条目。
“事务已结束”日志条目 - 每当机器人将事务状态设置为“成功”或“失败”时生成此条目。
“活动信息”日志条目 - 每当工作流中的活动“启动”、“出错”或“结束”时生成此条目。
默认情况下,在 Studio 中运行流程时,系统将记录 Trace 级别的日志。如要将日志记录设置为本地 Verbose 级别,请访问“调试”功能区,启用“日志活动”选项,然后在调试模式下运行流程。
访问日志
您可以在多个位置访问机器人执行日志:
在 UiPath Studio 的“输出面板”中,适用于在 Studio 中执行的上一个流程。
%localappdata%\UiPath\Logs\ _Execution.log 文件中,适合在计算机的 UiPath Studio 中运行的所有流程。根据是否激活 Verbose 级别,系统会生成 Trace 及更高级别或 Verbose 及更高级别的日志。
%localappdata%\UiPath\Logs_Execution.log 文件中,适合在计算机的 UiPath Assistant 中运行的所有流程。系统会生成在 UiPath Assistant 中定义的级别及更高级别的日志。
在连接到 Orchestrator 的情况下运行流程时,在 Orchestrator 的“日志”部分中。系统会以定义的级别及更高级别生成日志。
日志条目的构成
默认日志字段存在于所有日志中:
Message:日志消息。
Level:定义日志严重性。
Timestamp:执行操作的确切日期和时间。
FileName:正在“执行”的 .xaml 文件的名称。
JobId:运行流程的作业键。
ProcessName:触发日志记录的流程名称。
ProcessVersion:流程的版本号。
WindowsIdentity:执行了所记录操作的用户的名称。
RobotName:机器人的名称(在 Orchestrator 中定义)。
除了默认字段外,日志还会包含特定于类型的字段和用户定义的字段。
- 系统会根据日志类型显示特定于类型的字段,例如,对于“执行结束”,系统会显示“总执行时间(以秒位单位)”和“总执行时间”。
- 用户定义字段在 Studio 中定义(通过使用“添加日志字段”活动),并在生成活动后出现在所有生成的日志中,除非这些字段被“删除日志字段”活动(以编程方式)删除。
用户和机器人帐户
在 Orchestrator 中,拥有 Attended 许可证的人类用户(机器人或 Studio)和 Unattended Robot 都需要拥有相应的 Orchestrator 用户。
根据部署类型和组织设置,系统会通过不同的方式添加和管理用户:
- 可以在本地部署的独立 Orchestrator 中本地添加用户。
- 必须在 Automation Cloud 中添加用户,然后在 Cloud Orchestrator 中为其授予许可证。
- 如果事先已配置集成,则可以通过 Active Directory 在本地部署和 Cloud Orchestrator 中添加用户。
必须在 Automation Cloud 中创建机器人帐户,并且就拥有的权限而言,此类帐户的行为类似于用户帐户。而与用户帐户仅有的区别在于:
- 不能为机器人帐户配置任何与交互相关的流程。
- 无需使用电子邮件地址即可创建机器人帐户。
如何将 Unattended Robot 连接到 Orchestrator
步骤1:
在 Automation Cloud 和 Orchestrator 中:
- 导航到 Automation Cloud 中的“管理员”选项卡,然后导航到“帐户和组”,邀请 Automation User 组中的用户。
- 打开 Orchestrator 并转到租户级别的“管理访问权限”。
- 将角色分配给您的用户,并向其授予“Allow to be Automation User”角色。
- 在“机器人设置”选项卡中,将“Unattended Robot”选项切换为“已启用”。
- 检查计算机登录凭据并:
- 添加域/用户名(如果您使用的是 Windows 计算机,则添加计算机名称)。
- 添加 Windows 密码(如果存在)。
- 在租户级别的“计算机”下创建计算机模型,并分配至少一个 Unattended 运行时。
- 创建文件夹。将用户和计算机模板均分配给该文件夹。
- 如果可能,向新建的文件夹添加流程,以进行一些练习。
步骤2:
在将部署 Unattended Robot 的计算机上:
- 打开 UiPath Assistant。
- 在“首选项”菜单中选择“首选项”。“首选项”窗口就会显示。
- 导航到“Orchestrator 设置”。
- 在“Orchestrator URL”字段中输入 Orchestrator 的网址(仅输入第一部分,直至租户名称)。
- 在“计算机密钥”字段中输入由 Orchestrator 中的计算机实体生成的密钥。
- 单击“连接”。
步骤3(可选):
如果创建了一个流程并成功部署了 Unattended Robot,则可以通过运行作业来使机器人开始工作。
什么是队列?
队列是可以容纳任意数量项目的容器。默认情况下,项目可以以自由格式存储多种类型的数据。如果需要特定的数据架构,可以在创建队列时以 JSON 文件的形式上传此类数据。
Orchestrator 中的队列将存储项目,并将其单独分配给机器人以用于处理。队列还会根据流程结果监控项目的状态。队列项目进入处理阶段后就会成为事务。项目是不可分割的工作单位:客户合同、发票、投诉等。
为什么需要队列?
在强调复杂逻辑的大规模自动化场景中,使用队列非常实用。此类场景会带来许多挑战,例如将来自多个源的项目组合在一起,根据独特的逻辑处理这些项目,有效地利用资源或在单个项目和队列级别报告功能,包括使用 SLA。
考虑以下情况,零售公司通过表单执行的客户注册流程:客户可能来自不同的源(在线、合作伙伴、自己的商店、呼叫中心),因此,通过流畅的流程将其添加到处理线非常重要。此外,使用队列可确保在 SLA 时间限制内处理上述情况。
创建队列
在 Orchestrator 中,可以通过菜单中拥有相同名称的条目轻松创建队列。队列是文件夹实体,可实现设置细化权限。
创建队列时,您可以设置“最多重试次数”(希望队列项目重试的次数)和“唯一引用”字段(如果您希望事务引用为唯一,请选择“是”)。您可以更新现有队列设置,例如:
队列名称。
自动重试选项。
最多重试次数。
在 Orchestrator 中,默认情况下新创建的队列为空。如要使用项目填充它们,您可以使用 Orchestrator 中的上传功能或 Studio 活动。Orchestrator 支持直接批量上传 .csv 文件。
什么是事务?
事务是指对数据进行处理所需要的最小(原子)数据量以及必要的步骤,其目的是为了完成业务流程的一个部分。从邮箱中读取一封电子邮件,然后从电子邮件中提取数据的流程就是一个典型事务示例。
我们把事务数据称为原子数据,是因为完成数据处理后,即可假设在继续处理业务流程时不再需要这些数据。