第 2 章 使用 must-gather 下载日志文件和诊断信息

流程

• 从连接到 OpenShift Container Storage 集群的客户端运行 must-gather 命令：

  $ oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.8 --dest-dir=<directory-name>

  这会在指定目录中收集以下信息：

  • 所有与 OpenShift Container Storage 集群相关的自定义资源(CR)及其命名空间。
  • 与 OpenShift Container Storage 相关的所有 Pod 的 Pod 日志。
  • 某些标准 Ceph 命令的输出，如状态、集群运行状况等。

命令变体

• 如果一个或多个 master 节点没有处于 Ready 状态，请使用 --node-name 指定一个状态为 Ready 的 master 节点，以便可以安全地调度 must-gather pod。

  $ oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.8 --dest-dir=<directory-name> --node-name=<node-name>

• 如果要从特定时间收集信息：

  • 要为收集的日志指定相对时间段（例如在 5 秒内或在 2 天内），添加 /usr/bin/gather since=<duration>：

    $ oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.8 --dest-dir=<directory-name> /usr/bin/gather since=<duration>

  • 要指定在以后的一个特定时间收集日志，添加 /usr/bin/gather since-time=<rfc3339-timestamp>：

    $ oc adm must-gather --image=registry.redhat.io/ocs4/ocs-must-gather-rhel8:v4.8 --dest-dir=<directory-name> /usr/bin/gather since-time=<rfc3339-timestamp>

  按如下方式替换这些命令中的示例值：

  <node-name>

  如果一个或多个 master 节点没有处于 Ready 状态，使用这个参数指定一个仍然处于 Ready 状态的 master 节点名称。这可避免调度错误，确保 must-gather pod 没有调度到未就绪的 master 节点上。

  <directory-name>

  must-gather 收集的信息的目录。

  <duration>

  指定收集信息的时长（相对时长），例如 5h （代表从 5 小时以前开始）。

  <rfc3339-timestamp>

  指定收集信息的时常（RFC 3339 时间戳），例如 2020-11-10T04:00:00+00:00（代表从 2020 年 11 月 11 日 4am UTC 开始）。