关于诊断工具

The UiPath^® Diagnostic Tool is a standalone utility, enabling you to better collect and preview diagnostics info, which is then packaged and can be sent to our technical support team to help you solve potential problems.

它与各种收集器捆绑在一起，可帮助您仅收集所需的信息。此外，您可以将选定的收集器另存为配置文件，以备后用。可以从 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` 包的输出。