第 5 章 收集集群数据
在提交问题单时同时提供您的集群信息,可以帮助红帽支持为您进行排除故障。您可以使用 must-gather、sosreport 和集群节点日志等工具来收集诊断数据。
您可以在打开支持问题单时收集有关 OpenShift Container Platform 集群的调试信息,以便向红帽支持提供。
5.1. 关于 must-gather 工具 复制链接链接已复制到粘贴板!
oc adm must-gather CLI 命令可收集最有助于解决问题的集群信息,包括:
- 资源定义
- 服务日志
默认情况下,oc adm must-gather 命令使用默认的插件镜像,并写入 ./must-gather.local。
另外,您可以使用适当的参数运行命令来收集具体信息,如以下部分所述:
要收集与一个或多个特定功能相关的数据,请使用
--image参数和镜像,如以下部分所述。例如:
$ oc adm must-gather \ --image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.21.16要收集审计日志,请使用
-- /usr/bin/gather_audit_logs参数,如以下部分所述。例如:
$ oc adm must-gather -- /usr/bin/gather_audit_logs注意- 作为默认信息集合的一部分,不会收集审计日志来减小文件的大小。
-
在 Windows 操作系统上,安装
cwRsync客户端,并添加到PATH变量中,以便与oc rsync命令一起使用。
当您运行 oc adm must-gather 时,集群的新项目中会创建一个带有随机名称的新 pod。在该 pod 上收集数据,并保存在当前工作目录中以 must-gather.local 开头的新目录中。
例如:
NAMESPACE NAME READY STATUS RESTARTS AGE
...
openshift-must-gather-5drcj must-gather-bklx4 2/2 Running 0 72s
openshift-must-gather-5drcj must-gather-s8sdh 2/2 Running 0 72s
...
另外,您可以使用 --run-namespace 选项在特定命名空间中运行 oc adm must-gather 命令。
例如:
$ oc adm must-gather --run-namespace <namespace> \
--image=registry.redhat.io/container-native-virtualization/cnv-must-gather-rhel9:v4.21.16
5.1.1. 为红帽支持收集您的集群数据 复制链接链接已复制到粘贴板!
您可使用 oc adm must-gather CLI 命令收集有关您的集群的调试信息。
如果要收集信息来调试自管理的托管集群,请参阅"收集信息以对托管 control plane 进行故障排除"。
先决条件
-
您可以使用具有
cluster-admin角色的用户访问集群。 -
已安装 OpenShift Container Platform CLI (
oc)。
流程
进入要存储
must-gather数据的目录。注意如果集群在断开连接的环境中,则需要执行额外的步骤。如果您镜像的容器镜像仓库有一个信任的 CA,您必须首先将这个信任的 CA 添加到集群中。对于在断开连接的环境中的所有集群,您必须导入默认的
must-gather镜像作为镜像流。$ oc import-image is/must-gather -n openshift运行
oc adm must-gather命令:$ oc adm must-gather重要如果您位于断开连接的环境中,请使用
--image标志作为 must-gather 的一部分,指向有效负载镜像。注意因为这个命令会默认会选择一个随机 control plane 节点,所以 pod 可能会被调度到处于
NotReady和SchedulingDisabled状态的 control plane 节点。如果此命令失败,例如,您无法在集群中调度 pod,则使用
oc adm inspect命令来收集特定资源的信息。注意请联络红帽支持以获取推荐收集的资源信息。
从刚刚在您的工作目录中创建的
must-gather目录创建一个压缩文件。确保为唯一的 must-gather 数据提供日期和集群 ID。有关如何查找集群 ID 的更多信息,请参阅如何在 OpenShift 集群上找到 cluster-id 或名称。例如,在使用 Linux 操作系统的计算机上运行以下命令:$ tar cvaf must-gather-`date +"%m-%d-%Y-%H-%M-%S"`-<cluster_id>.tar.gz <must_gather_local_dir>其中:
<must_gather_local_dir>- 使用实际目录名称替换。
- 在红帽客户门户网站的客户支持页面中,将压缩文件附加到您的支持问题单中。