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 命令收集信息:

  1. 了解 must-gather 命令以及使用 OpenShift Container Platform 文档中的 收集集群数据 所需的先决条件。
  2. 登录到您的全局 hub 集群。对于典型的用例,在登录到全局 hub 集群时运行以下命令:

    oc adm must-gather --image=quay.io/stolostron/must-gather:SNAPSHOTNAME

    如果要检查您的受管 hub 集群,请在这些集群中运行 must-gather 命令。

  3. 可选: 如果要将结果保存到 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-resourcesnamespaces 资源。
  • 每个对等级别下的子类:用于 cluster-scope 和 namespace-scoped 资源的自定义资源定义的 API 组。
  • 每个的下一级别:按 kind 排序的 YAML 文件。
  • 对于全局 hub 集群,您可以在命名空间资源中检查 PostgresClusterKafka
  • 对于全局 hub 集群,您可以在 命名空间 资源的 pod 中检查多集群全局 hub 相关 pod 和日志。
  • 对于受管 hub 集群,您可以检查多集群全局 hub 代理 pod,并在 命名空间 资源的 pod 中检查日志。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

© 2024 Red Hat, Inc.