红帽全球峰会1.3. Red Hat Edge Manager 代理的 must-gather 步骤
要调试设备上的 Red Hat Edge Manager 代理，您可以使用 flightctl-must-gather 命令。
需要的访问权限：集群管理员
请参见以下步骤：
- 在您要调试的设备中运行以下命令：
sudo flightctl-must-gather
1.3.1. 托管集群的 must-gather
如果您在托管 control plane 集群时遇到问题，您可以运行 must-gather 命令来收集信息，以帮助您进行故障排除。
1.3.1.1. 关于托管集群的 must-gather 命令
该命令为受管集群和托管集群生成输出。
来自多集群引擎 operator hub 集群的数据：
- 集群范围的资源：这些资源是管理集群的节点定义。
-
hypershift-dump压缩文件：如果您需要与其他人员共享内容，则此文件很有用。 - Namespaced resources ：这些资源包括相关命名空间中的所有对象，如配置映射、服务、事件和日志。
- 网络日志：这些日志包括 OVN 北向和南向数据库和南向数据库和各个日志的状态。
- 托管的集群 ：此输出级别涉及托管集群中的所有资源。
来自托管集群的数据：
- 集群范围资源 ：这些资源包括所有集群范围的对象，如节点和 CRD。
- Namespaced resources ：这些资源包括相关命名空间中的所有对象，如配置映射、服务、事件和日志。
虽然输出不包含集群中的任何 secret 对象，但它可以包含对 secret 的名称的引用。
1.3.1.2. 先决条件
要运行 must-gather 命令来收集信息，您必须满足以下先决条件：
-
您必须确保
kubeconfig文件已加载，并指向 multicluster engine operator hub 集群。 - 您必须具有 multicluster engine operator hub 集群的 cluster-admin 访问权限。
-
您必须具有
HostedCluster资源的 name 值，以及部署自定义资源的命名空间。
1.3.1.3. 为托管集群输入 must-gather 命令
输入以下命令收集有关托管集群的信息。在命令中，
hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE参数是可选的；如果您没有包括它，则命令像托管集群位于默认命名空间中一样，即集群。oc adm must-gather --image=quay.io/stolostron/backplane-must-gather:SNAPSHOTNAME /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME
要将命令的结果保存到压缩文件中，请包含
--dest-dir=参数，将 NAME 替换为您要保存结果的目录的名称：NAMEoc adm must-gather --image=quay.io/stolostron/backplane-must-gather:SNAPSHOTNAME /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME --dest-dir=NAME ; tar -cvzf NAME.tgz NAME
1.3.1.4. 在断开连接的环境中输入 must-gather 命令
在断开连接的环境中，按照以下步骤运行 must-gather 命令：
- 在断开连接的环境中，将 RedHat operator 目录镜像镜像（mirror）到其 mirror registry 中。如需更多信息，请参阅 在断开连接的网络环境中安装。
运行以下命令以提取日志，从其 mirror registry 中引用镜像：
REGISTRY=registry.example.com:5000 IMAGE=$REGISTRY/multicluster-engine/must-gather-rhel8@sha256:ff9f37eb400dc1f7d07a9b6f2da9064992934b69847d17f59e385783c071b9d8 oc adm must-gather --image=$IMAGE /usr/bin/gather hosted-cluster-namespace=HOSTEDCLUSTERNAMESPACE hosted-cluster-name=HOSTEDCLUSTERNAME --dest-dir=./data
1.3.1.5. 其他资源
- 有关托管 control plane 故障排除的更多信息，请参阅 OpenShift Container Platform 文档中的 托管 control plane 故障排除。
