1.15. 使用 must-gather 命令进行故障排除


1.15.1. 症状:带有多集群全局 hub 的错误

您可能会遇到多集群全局 hub 的各种错误。您可以运行 must-gather 命令来排除多集群全局 hub 的问题。

1.15.2. 解决问题: 运行 must-gather 命令进行 dubugging

运行 must-gather 命令来收集详情、日志并采取调试问题的步骤。当您请求支持时,这个调试信息会很有用。oc adm must-gather CLI 命令会收集解决问题通常需要的集群信息,包括:

  • 资源定义
  • 服务日志

1.15.2.1. 先决条件

运行 must-gather 命令必须满足以下先决条件:

  • 使用具有 cluster-admin 角色的用户访问全局 hub 和受管 hub 集群。
  • 安装了 OpenShift Container Platform CLI(oc)。

1.15.2.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>

    您可以为目录指定不同的名称。

    注意: 命令包括创建 gzip 压缩 tarball 文件所需的添加内容。

must-gather 命令收集以下信息:

  • 两个对等级别: cluster-scoped-resourcesnamespaces 资源。
  • 每个对等级别下的子类:用于 cluster-scope 和 namespace-scoped 资源的自定义资源定义的 API 组。
  • 每个的下一个级别:按 kind 进行排序的 YAML 文件。
  • 对于全局 hub 集群,您可以在命名空间资源中检查 PostgresClusterKafka
  • 对于全局 hub 集群,您可以检查 multicluster global hub 相关 pod,并在 命名空间 资源的 pod 中记录日志。
  • 对于受管 hub 集群,您可以检查 multicluster global hub 代理 pod,并在 命名空间 资源的 pod 中记录日志。
Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.