关于诊断工具

UiPath 诊断工具是一个独立的实用程序，可以让您全面地收集和预览诊断信息，然后将其打包并发送给我们的技术支持团队，以帮助您解决潜在问题。

它与各种收集器捆绑在一起，可帮助您仅收集所需的信息。此外，您可以将选定的收集器另存为配置文件，以备后用。可以从 Studio、机器人、RobotJS、活动和 Orchestrator 中收集信息。

您可以从 Automation Cloud 实例中的资源中心下载诊断工具。

它还随 Studio 一起安装，您可以在 C:\Program Files\UiPath\Studio 文件夹（对于按计算机安装）或 %localappdata%\Programs\UiPath\Studio 文件夹（对于按用户安装）中找到它。

要访问它，只需单击“开始”按钮，然后搜索“诊断工具”应用程序。

开始部分

诊断工具基于使用收集器收集信息的配置文件。配置文件是一组收集器，可专门根据您遇到的问题来收集特定信息。该工具包含若干个预定义的配置文件，每个配置文件都有一组特定的收集器，但您也可以根据每一个特定问题创建自己的配置文件。即使开始时使用预定义的配置文件，以后也可以根据收集特定信息的需要添加或删除收集器。

配置文件	描述
Studio/机器人/活动问题	收集有关 Studio、机器人或活动的信息。默认情况下，此配置文件已启用多个收集器。
Orchestrator 问题	收集您与 Orchestrator 连接状况的相关信息。默认情况下，此配置文件已启用多个收集器。
清空配置文件	此配置文件没有任何选定的收集器。您可以在此使用所需的收集器创建自定义配置文件，以便供之后使用。
自定义位置	根据您提供的 .json 文件收集信息。您可以选择要使用的收集器。

此外，您可以选择导入先前使用收集到的数据生成的 .zip 包以进行查看。

配置部分

此部分提供所有收集器。前两个配置文件已经添加若干个收集器，不过您也可以添加其他收集器或删除现有收集器。可用的收集器如下所示：

收集器	已收集信息
注册表信息	使用的注册表项以及相应的值名称和值数据。
屏幕信息	显示使用的一个或多个显示器，以及类型、分辨率、DPI 和偏移坐标。
事件日志	为所选应用程序生成 .evtx 日志文件。 此收集器可与以下筛选条件一起使用： • 期间（天数） • 事件级别 • 来源筛选器（以逗号分隔的应用程序来源列表）
环境变量	基于可配置的语句使用的系统或本地环境变量。
计算机信息	计算机的名称、域、操作系统、会话、管理员和代理设置。
日志文件	执行、Studio、ETL 和组合式日志。您可以分别从每个部分查看和导出相应内容。
流程信息	使用的系统流程。
第三方安装	列出使用的所有第三方应用程序。
UiPath 安装	列出该计算机上已安装的所有 UiPath 产品，以及版本、类型和路径。
许可证	显示许可证类型和状态。
设置文件	列出可用的 UiPath.settings、UiStudio.settings、UiStudio.v2.settings 和 NuGet.config 文件，并可以访问这些文件。
Orchestrator 网页配置	根据指定的注册表项位置及其值显示 Web.config 文件。
Orchestrator 应用程序主机文件	根据指定的文件夹显示 applicationhost.config 文件。
文件	使用可配置的 Pattern 从指定的 DirectoryPath 获取文件。
自定义注册表	从自定义路径检索使用的注册表项，以及相应的值名称和值数据。

如果您对提供的配置文件收集器不满意，只需单击相应收集器容器中的“x”按钮即可将其删除。

如果您认为需要更多收集器，请单击“添加新收集器”按钮，然后从列表中选择所需的收集器。

考虑到您多次想要使用某些收集器，您可以将其添加到列表中，然后单击“将配置文件导出至文件”按钮。此操作将生成 .json 文件，您以后可以从“开始”部分导入该文件。

有些收集器可以让您查看更详细的信息。

例如，“日志文件”收集器允许您在单独的窗口中浏览日志类型（“执行日志”、“Studio 日志”或“组合日志”）的收集文件，还可以查看日志文件的路径、打开日志文件，甚至选择要导出的日志文件。

同样，“注册表信息”收集器仅在“预览”部分显示前几项结果，但允许您在单独的窗口中查看所有结果，方法为：单击“显示 x/y”按钮，其中 x 表示显示的结果数， y 表示结果总数。

预览部分

此处会显示收集的所有信息。这些信息按分组分配在可折叠框中，以易于阅读。如果您对特定的收集器不满意，直接禁用即可，以使最终的包不会导出这些收集器。

您可以在此处禁用您认为不需要导出的收集器。只需取消选中所需的收集器，然后单击“下一步”。

出口部分

最后一部分显示该流程中使用的收集器的预览内容。现在，剩下要做的工作就是单击“导出”以将所有收集的数据保存在 .zip 包中，还可以打开保存文件的位置。如果要更改收集器，还可以在各部分之间导航。

命令行参数

您也可以从命令提示符或 Windows PowerShell 中使用诊断工具。无论使用哪种模式，参数及其结果都相同。

可以通过下列方式使用此工具：

• 命令提示符 - 打开命令提示符实例，并使用 cd 命令确定诊断工具的位置。然后，使用下方列出的参数之一。
• Windows PowerShell - 导航到诊断工具所在的位置，右键单击工具，选择在 PowerShell 中打开。然后，使用下方列出的参数之一。

示例：

UiPath.DiagnosticTool.exe run <[defaultProfile] | [pathToProfile> [Optional Parameter]

参数	描述
run studio	运行 Studio 默认配置文件。
run orchestrator	运行 Orchestrator 默认配置文件。
run <pathToFile>	从生成的 .json 文件运行先前创建的自定义诊断配置文件。
-o, --output	指定包含所有收集数据的已生成 .zip 包的输出。

生成诊断工具报告

要生成诊断工具报告，请执行以下操作：

1. 单击“开始”，然后搜索“UiPath Diagnostic Tool” 应用程序。
2. 在“开始”部分选择适当的选项，然后单击“下一步” 。
3. 在“配置” 部分中配置数据，然后单击“收集” 。
   注意：单击“上一个” 时，将出现一个删除当前进度的确认窗口。
4. 查看“预览”部分中的数据，然后单击“下一步” 。
5. 单击“导出”部分中的“导出”。
6. 保存生成的 .zip 文件。
7. 向技术支持团队发送生成的 .zip 文件。