使用 Automation Suite 支持捆绑包

Automation Suite 支持捆绑包工具、其内容及其如何帮助进行故障排除的概述。

概述

Automation Suite 支持捆绑包会收集 UiPath™ 服务的应用程序级别日志以及评估和修复问题所需的相关对象。 Automation Suite 支持捆绑包还包含历史日志，可用于在对问题进行故障排除时分析模式。 当仅通过查看集群状态并不能明确问题的潜在根本原因时，历史日志特别有用。

当向 UiPath™ 支持团队寻求指导或修复时，也需要 Automation Suite 支持捆绑包，因为他们需要该支持捆绑包进行分析。

备注：

Automation Suite 支持捆绑包不会收集或存储您、您的用户或自动化的任何 PII 或机密数据。 UiPath™ 应用程序不会泄漏或获取其记录中的任何机密信息。 在平台级别，日志收集器旨在掩盖任何此类关键信息。

Automation Suite 支持捆绑包工具参数

• 使用此工具时，还会生成一个 XML 文件，导出简要的使用情况和配置遥测数据。此遥测数据包括：
  • Automation Suite 安装配置详细信息（例如 Kubernetes 风格、安装模式、版本和已启用的服务，以及其他设置）。
  • 集群级别的资源使用情况信息（例如 CPU 和内存的可用性和利用率以及其他指标）。
  • UiPathctl 命令执行详细信息（状态、日志和持续时间等详细信息）。
  • 使用情况遥测：
    • 按机器人类型划分的每月机器人执行持续时间。
    • 机器人并发 - 同时执行操作的最大机器人数量。
    • 有关作业运行、流程运行、队列项目、作业失败率和用户的指标。
    • 环境信息。
    • AI Units使用情况摘要（如果您使用AI Center 。
• UiPath 仅将此数据用于内部报告，以加强对客户的了解，并改善支持质量和整体体验。
• 您可以在Customer Portal中上传 XML 文件，以与 UiPath 支持团队共享您的高级自托管使用情况遥测数据。
• 若要查看 XML 文件，请使用 SQL Server Management Studio 或任何 XML 查看器打开该文件。
• 您可以使用--exclude=service-metrics选项将service-metrics添加到排除列表中，以停止生成摘要遥测。此选项在 Automation Suite 2.2510 及更高版本中可用。

生成支持捆绑包

要生成支持捆绑包，请从安装程序目录运行以下命令：

./bin/uipathctl health bundle cluster_config.json --versions versions/helm-charts.json

从 Automation Suite 2.2510.1 开始，指向配置文件 ( cluster_config.json ) 和版本文件 ( helm-charts.json ) 参数的路径是可选的。您只需运行以下命令即可生成支持捆绑包：

./bin/uipathctl health bundle

此工具需要一些时间来收集所有日志，并将其存储在本地或管理计算机上的临时位置。

下表列出了可用于支持捆绑包工具的可选标志：

标记	描述
--output-dir string	指定用于存储支持包的目录。
--namespace string	指定部署 UiPath Automation Suite 的命名空间。
--include string	指定要包含在捆绑包中的其他组件（以逗号分隔）（例如--include=historical-logs ）。
--exclude string	指定要从捆绑包中排除的组件（以逗号分隔，例如--exclude=rke2-bundle或--exclude=service-metrics ）。
--from YYYY-MM-DD	收集历史日志的开始日期，格式为 YYYY-MM-DD。
--days int	自收集历史日志之开始日期起的天数。
--limit-bytes int	通过提供整数值（以字节为单位），限制正在运行的 Pod 的日志大小。

默认情况下，如果未指定--from标志，则无论指定的--days为何，都将收集从今天开始过去 2 天的历史日志。 如果指定--from --days但未指定 ，则系统将收集自指定开始日期起 2 天内的历史日志。

默认情况下，支持捆绑包中包含 RKE2 捆绑包。 要排除它，请使用flag --exclude=rke2-bundle 。

默认情况下，支持捆绑包中不包含历史日志。 要包含它们，请使用--include=historical-logs标志。

Automation Suite 支持捆绑包结构

.tar.gz 存档包含以下文件和文件夹：

文件/文件夹	描述
logs	包含从 ceph 或外部对象存储收集的历史日志。
current-logs	包含实时日志（例如 Pod 的当前实例和上一个实例的日志）。
events.json	包含来自所有命名空间的事件说明。
alerts	包含集群中处于活动状态的 Prometheus 警示。
server0.tar.gz, server1.tar.gz, ...	包含集群中每个节点的 RKE2 捆绑包。
namespace/resource/object.yaml	包含服务器首选/自定义命名空间和集群范围资源的对象说明。
service-metrics	包含存储在单个 XML 文件中的高级配置和使用情况遥测。

RKE2 捆绑包结构如下：

目录	描述
systemlogs	包含与系统事件、安全审核和常规系统消息相关的日志。
systeminfo	包含有关正在运行的流程、磁盘使用情况、CPU 利用率等的信息。
etcd	包含与etcd键值存储的数据存储相关的信息。
journald	包含systemd-journald管理的日志。
networking	包含网络配置详细信息，例如 iptables、路由等。
rke2	包含 kubelet 日志、代理和服务器证书、有关 crictl 的信息、在集群上运行的资源以及 Pod 日志。