OpenShift 文档正在迁移，很快将仅在 docs.redhat.com（所有 Red Hat 产品文档的中心）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

生成诊断包

您可以生成诊断包并将数据发送给支持团队，以便他们深入了解Red Hat Advanced Cluster Security for Kubernetes组件的状态和运行状况。

在调查您遇到的Red Hat Advanced Cluster Security for Kubernetes问题期间，Red Hat可能会要求您发送诊断包。您可以生成诊断包并在发送前检查其数据。

诊断包未加密，根据您环境中集群的数量，包大小在100 KB到1 MB之间。始终使用加密通道将此数据传输回Red Hat。

诊断包数据

生成诊断包时，其中包含以下数据：

  • 中央堆配置文件。

  • 系统日志：所有Red Hat Advanced Cluster Security for Kubernetes组件的日志（最近20分钟）以及最近崩溃的组件的日志（从崩溃前最长20分钟）。系统日志取决于您环境的大小。对于大型部署，数据仅包括具有严重错误的组件的日志文件，例如高重启次数。

  • Red Hat Advanced Cluster Security for Kubernetes组件的YAML定义：此数据不包括Kubernetes密钥。

  • OpenShift Container Platform或Kubernetes事件：与stackrox命名空间中的对象相关的事件的详细信息。

  • 在线遥测数据，其中包括：

    • 存储信息：有关数据库大小以及附加卷中可用空间量的详细信息。

    • Red Hat Advanced Cluster Security for Kubernetes组件运行状况信息：有关Red Hat Advanced Cluster Security for Kubernetes组件版本、内存使用情况以及任何报告的错误的详细信息。

    • 粗粒度使用统计信息：有关API端点调用计数和报告的错误状态的详细信息。它不包括API请求中发送的实际数据。

    • 节点信息：有关每个受保护集群中节点的详细信息。包括内核和操作系统版本、资源压力和污点。

    • 环境信息：有关每个受保护集群的详细信息，包括Kubernetes或OpenShift Container Platform版本、Istio版本（如果适用）、云提供商类型以及其他类似信息。

使用RHACS门户生成诊断包

您可以使用RHACS门户中的系统运行状况仪表板生成诊断包。

先决条件

  • 生成诊断包需要对DebugLogs资源具有read权限。

步骤

  1. 在 RHACS 门户中，选择**平台配置** → **系统健康**。

  2. 在**系统健康**视图标题栏中，点击**生成诊断包**。

  3. 在**按集群筛选**下拉菜单中，选择要为其生成诊断数据的集群。

  4. 对于**筛选起始时间**，请指定要包含诊断数据的日期和时间（UTC 格式）。

  5. 点击**下载诊断包**。

使用 roxctl CLI 生成诊断包

您可以使用roxctl CLI、Red Hat Advanced Cluster Security for Kubernetes (RHACS) 管理员密码或 API 令牌以及中心地址来生成诊断包。

先决条件

  • 生成诊断包需要对Administration资源具有read权限。对于低于3.73.0版本的DebugLogs资源，这是必需的。

  • 您必须已配置 RHACS 管理员密码或 API 令牌以及中心地址。

步骤

  • 要使用 RHACS 管理员密码生成诊断包，请执行以下步骤

    1. 运行以下命令以配置ROX_PASSWORD和ROX_CENTRAL_ADDRESS环境变量

      $ export ROX_PASSWORD=<rox_password> && export ROX_CENTRAL_ADDRESS=<address>:<port_number> (1)
      1 对于<rox_password>，请指定 RHACS 管理员密码。

    2. 运行以下命令使用 RHACS 管理员密码生成诊断包

      $ roxctl -e "$ROX_CENTRAL_ADDRESS" -p "$ROX_PASSWORD" central debug download-diagnostics

  • 要使用 API 令牌生成诊断包，请执行以下步骤

    1. 运行以下命令以配置ROX_API_TOKEN环境变量

      $ export ROX_API_TOKEN=<api_token>

    2. 运行以下命令使用 API 令牌生成诊断包

      $ roxctl -e "$ROX_CENTRAL_ADDRESS" central debug download-diagnostics