1.2. 运行 must-gather 命令进行故障排除
要进行故障排除，参阅可以使用 must-gather 命令进行调试的用户情景信息，然后使用这个命令进行故障排除。
需要的访问权限：集群管理员
1.2.1. must-gather 情境
场景一： 如果您的问题已被记录，使用 已记录的故障排除文档部分进行解决。这个指南按照产品的主要功能进行组织。
在这种情况下，您可以参阅本指南来查看您的问题的解决方案是否在文档中。例如，在创建建集群时出现问题，您可能会在这个指南的 管理集群部分中找到解决方案。
-
情况 2：如果这个指南中没有与您的问题相关的内容，运行
must-gather命令并使用输出来调试问题。 -
情况 3：无法使用
must-gather命令的输出结果无法帮助解决您的问题，请向红帽支持提供您的输出。
1.2.2. must-gather 过程
请参阅以下流程来使用 must-gather 命令：
-
了解
must-gather命令以及按照 Red Hat OpenShift Container Platform 文档中的收集集群数据 所需的先决条件。 登录到您的集群。添加用于收集数据和目录的 Red Hat Advanced Cluster Management for Kubernetes 镜像。运行以下命令，在其中提供您要插入的镜像和输出目录：
oc adm must-gather --image=registry.redhat.io/rhacm2/acm-must-gather-rhel8:v2.5.0 --dest-dir=<directory>
对于通常的用例，您应该在登录到 hub 集群时运行
must-gather。备注：要检查您的受管集群，找到位于
cluster-scoped-resources目录中的gather-managed.log文件：<your-directory>/cluster-scoped-resources/gather-managed.log>
检查 JOINED 和 AVAILABLE 栏没有被设置为
True的受管集群。您可以在这些没有以True状态连接的集群中运行must-gather命令。进入您指定的目录查看输出。输出以以下级别进行组织：
-
两个对等级别：
cluster-scoped-resources和namespace资源。 - 每个对等级别下的子类：用于 cluster-scope 和 namespace-scoped 资源的自定义资源定义的 API 组。
-
每个子类的下一级： 按
kind进行排序的 YAML 文件。
-
两个对等级别：
1.2.3. 在断开连接的环境中的 must-gather
在断开连接的环境中，按照以下步骤运行 must-gather 命令：
- 在断开连接的环境中，将 RedHat operator 目录镜像镜像（mirror）到其 mirror registry 中。如需更多信息，请参阅在断开连接的网络中安装。
- 运行以下命令以提取日志，从其 mirror registry 中引用镜像：
REGISTRY=registry.example.com:5000 IMAGE=$REGISTRY/rhacm2/acm-must-gather-rhel8@sha256:ff9f37eb400dc1f7d07a9b6f2da9064992934b69847d17f59e385783c071b9d8 oc adm must-gather --image=$IMAGE --dest-dir=./data
