1.17. 运行 must-gather 命令进行故障排除
运行 must-gather
命令来收集详情、日志并采取调试问题的步骤。当您请求支持时,这个调试信息会很有用。oc adm must-gather
CLI 命令收集从集群收集调试问题通常需要的信息,包括:
- 资源定义
- 服务日志
1.17.1. 先决条件
您必须满足以下先决条件才能运行 must-gather
命令:
-
以具有
cluster-admin
角色的用户访问全局 hub 和受管 hub 集群。 - 安装了 OpenShift Container Platform CLI(oc)。
1.17.2. 运行 must-gather 命令
完成以下步骤,使用 must-gather 命令收集信息:
-
了解
must-gather
命令以及使用 OpenShift Container Platform 文档中的 收集集群数据 所需的先决条件。 登录到您的全局 hub 集群。对于典型的用例,在登录到全局 hub 集群时运行以下命令:
oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME
如果要检查您的受管 hub 集群,请在这些集群中运行
must-gather
命令。可选: 如果要将结果保存到
SOMENAME
目录中,您可以运行以下命令而不是上一步中的结果:oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME --dest-dir=<SOMENAME> ; tar -cvzf <SOMENAME>.tgz <SOMENAME>
您可以为目录指定不同的名称。
注意: 命令包括创建 gzipped tarball 文件所需的添加。
从 must-gather
命令收集以下信息:
-
两个对等级别:
cluster-scoped-resources
和namespaces
资源。 - 每个对等级别下的子类:用于 cluster-scope 和 namespace-scoped 资源的自定义资源定义的 API 组。
- 每个的下一级别:按 kind 排序的 YAML 文件。
-
对于全局 hub 集群,您可以在命名空间资源中检查
PostgresCluster
和Kafka
。 -
对于全局 hub 集群,您可以在
命名空间
资源的 pod 中检查多集群全局 hub 相关pod
和日志。 -
对于受管 hub 集群,您可以检查多集群全局 hub 代理 pod,并在
命名空间
资源的pod
中检查日志。