ODF must-gather

odf-must-gather is a tool built on top of OpenShift must-gather that expands its capabilities to gather Openshift Container Storage for information.

Usage

oc adm must-gather --image=quay.io/rhceph-dev/odf4-odf-must-gather-rhel9:latest-4.13

The command above will create a local directory with a dump of the ocs state. Note that this command will only get data related to the ocs part of the OpenShift cluster.

You will get a dump of:

  • The OCS Operator namespaces (and its children objects)
  • All namespaces (and their children objects) that belong to any OCS resources
  • All OCS CRD's definitions
  • All namespaces that contains ceph and noobaa
  • Output of the following ceph commands
    ceph status
    ceph health detail
    ceph osd tree
    ceph osd stat
    ceph osd dump
    ceph mon stat
    ceph mon dump
    ceph df
    ceph report
    ceph osd df tree
    ceph fs dump
    ceph fs ls
    ceph pg dump
    ceph health detail
    ceph osd crush show-tunables
    ceph osd crush dump
    ceph mgr dump
    ceph mds stat
    ceph versions
    

In order to get data about other parts of the cluster (not specific to OCS) you should run oc adm must-gather (without passing a custom image). Run oc adm must-gather -h to see more options.

How to Contribute