When opening a support case, it is helpful to provide debugging information about your cluster to Red Hat Support.
must-gather tool enables you to collect diagnostic information about your
OpenShift Container Platform cluster, including virtual machines and other data related to
OpenShift sandboxed containers.
For prompt support, supply diagnostic information for both OpenShift Container Platform and OpenShift sandboxed containers.
oc adm must-gather CLI command collects the information from your cluster that is most likely needed for debugging issues, such as:
You can specify one or more images when you run the command by including the
--image argument. When you specify an image, the tool collects data related to that feature or product.
When you run
oc adm must-gather, a new pod is created on the cluster. The data is collected on that pod and saved in a new directory that starts with
must-gather.local. This directory is created in the current working directory.
You can use the
oc adm must-gather CLI command to collect information about your cluster. The following features and objects are associated with OpenShift sandboxed containers:
All namespaces and their child objects that belong to any OpenShift sandboxed containers resources
All OpenShift sandboxed containers custom resource definitions (CRDs)
oc adm must-gather CLI command collects the following component logs:
OpenShift sandboxed containers logs
These component logs are collected as long as there is at least one pod running with the
To collect OpenShift sandboxed containers data with
must-gather, you must specify the
OpenShift sandboxed containers image:
For more information about gathering data for support, see Gathering data about your cluster.