使用 Bot Agent 诊断实用程序处理 Bot Runner 设备和 Control Room 之间的连接相关问题。 该实用程序通过提供解决方案或帮助解决问题的建议来帮助诊断问题。

先决条件

确保 Bot Agent 已安装在用户设备中。

过程

  1. 打开 Windows 命令提示符。
  2. 导航到 Bot Agent 安装路径。
    • 在系统级别安装 Bot Agent 的默认路径是 C:\Program Files\Automation Anywhere\Bot Agent。
    • 在本地用户级别安装 Bot Agent 的默认路径是 %USERPROFILE%\AppData\Local\Programs\Automation Anywhere\Bot Agent。
  3. 输入 AADiagnosticUtility.exe 运行 Bot Agent 诊断实用程序。
    显示执行诊断检查的各种选项及其描述。
    选项 描述
    -checkDownloadError <CR_URL> 如果 bot 部署失败，请检查 bot 依赖项下载错误。
    注： 错误消息保存在设备内存中，并在 Bot Agent 服务重新启动时被移除。

    在 Bot Runner 设备连接到 Control Room 但自动化失败时使用此选项，因为依赖包未下载到 Bot Runner 设备上。 在这种情况下，该实用程序会提出进一步诊断的建议。
    -checkProxy <CR_URL> 检查设备上的代理设置。

    在 Bot Runner 设备无法连接到 Control Room 时，请使用此选项来验证代理是否可用或已配置供 Bot Agent 使用。

    还为您提供了使用 importProxy 选项导入代理设置的选项。

    注： 验证代理的设备代理设置可在 Bot Agent 注册过程中进行设置，并可通过 Bot Agent 诊断实用程序进行更新。 设备上的所有用户都使用相同的凭据。
    -checkWSError <CR_URL> 检查 WebSocket 连接和错误。
    注： 错误消息保存在设备内存中，并在 Bot Agent 服务重新启动时从 Windows 任务管理器的“服务”选项卡移除。

    当 Bot Runner 设备由于 WebSocket 连接错误而无法连接到 Control Room 时，此选项提供了可能进行进一步调查的原因。
    -collectLogs 通过捕获 Bot Runner 设备的多个日志，减少收集问题信息所需的周转时间。
    使用此选项捕获并保存当前日期节点管理器、bot 启动程序和事件查看器日志，用于在运行该实用程序的设备上的压缩文件夹中进行调试和故障排除。
    • 对于安装在系统级别的Bot Agent，日志保存在C:\ProgramData\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip。
    • 对于安装在本地用户级别的Bot Agent，日志保存在 %USERPROFILE%\AppData\Local\AutomationAnywhere\BotRunner\Logs\bot_agent_logs_<datetimestamp>.zip。
    注：
    • 要捕获安全事件的 Windows 日志，请以提升的权限运行该实用程序（以管理员身份运行）。

      如果您在没有提升权限的情况下运行该实用程序，则会显示以下错误：

      错误： 无法捕获 security_event_viewer_<date>.evtx
    • 为了节省存储空间，请在调试后删除该文件。
    -configProxy <CR_URL> 检查代理配置并配置代理凭据（如果需要）。

    当 Bot Runner 设备由于缺失身份验证服务器的凭据而无法连接到 Control Room 时，使用此选项可配置代理服务器凭据。 验证连接问题是否已通过登录到 Control Room 解决。
    -importProxy <CR_URL> 将代理设置从登录的用户设备导入到系统用户设备。
    注： 您必须具有管理员权限才能导入代理设置。

    当 Bot Runner 设备由于代理服务器问题而无法连接到 Control Room 时，使用此选项可将代理设置从 Bot Agent 的登录用户导入到系统用户。

    此选项提供有关以下内容的信息：
    • 代理服务器是否经过身份验证。
    • Control Room URL 是否被添加到代理服务器的安全收件人列表中。
    • 是否允许将 WebSocket 连接作为代理配置的一部分。
    -importSSLCertificate path_to_ssl_certificate 如果需要，将 SSL 证书导入 Java 凭据存储。
    注： 您必须具有管理员权限才能导入 SSL 证书。

    当 Bot Runner 设备因无效的 SSL 证书而无法连接到 Control Room 时，使用此选项可导入 SSL 证书。 必须确保有效证书文件位于 importSSLCertificatepath_to_ssl_certificate 选项中指定的文件位置。

    必须重新启动 Automation Anywhere Bot Agent 服务才能使导入的证书生效。
    -list 查看本地设备上的活动 bot 部署。

    使用此选项检查并列出正在运行的自动化 (bots)。
    -ping <CR_URL> 检查 Control Room 和 Bot Runner 设备之间的连接。

    使用此选项检查 Bot Runner 设备是否可以 ping 到（到达）Control Room。
    -validateSSLCertificate <CR_URL> 检查有效 SSL 证书并查看证书是否有效。
    注： 您必须具有读取权限才能执行此检查。

    当 Bot Runner 设备因无效的 SSL 证书而无法连接到 Control Room 时，使用此选项可检查并查看 SSL 证书是否有效。 要解决此问题，请使用 importSSLCertificate 选项。
  4. 在命令提示符中输入以下选项：<filepath>\AADiagnosticUtility.exe -<option> <CR_URL>
    例如，要验证 WebSocket 错误，请在命令提示符中输入以下内容： AADiagnosticUtility.exe -checkWSError https://yourcrurl.com/
    该选项返回以下结果： 最近此设备没有遇到任何 Web Socket 错误

    使用其他选项执行进一步的诊断检查。