Chapter 2. Gathering data about your cluster
When opening a support case, it is often helpful to provide debugging information about your cluster to Red Hat Support.
It is recommended to provide:
2.1. About the must-gather tool
The oc adm must-gather
CLI command collects the information from your cluster that is most likely needed for debugging issues, such as:
- Resource definitions
- Audit logs
- Service logs
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.
2.2. Gathering data about your cluster for Red Hat Support
You can gather debugging information about your cluster by using the oc adm must-gather
CLI command.
Prerequisites
-
Access to the cluster as a user with the
cluster-admin
role. -
The OpenShift Container Platform CLI (
oc
) installed.
Procedure
-
Navigate to the directory where you want to store the
must-gather
data. Run the
oc adm must-gather
command:$ oc adm must-gather
NoteIf this command fails, for example if you cannot schedule a Pod on your cluster, then use the
oc adm inspect
command to gather information for particular resources. Contact Red Hat Support for the recommended resources to gather.NoteIf your cluster is using a restricted network you must import the default must-gather image before running the
oc adm must-gather
command.$ oc import-image is/must-gather -n openshift
Create a compressed file from the
must-gather
directory that was just created in your working directory. For example, on a computer that uses a Linux operating system, run the following command:$ tar cvaf must-gather.tar.gz must-gather.local.5421342344627712289/ 1
- 1
- Make sure to replace
must-gather-local.5421342344627712289/
with the actual directory name.
- Attach the compressed file to your support case on the Red Hat Customer Portal.
2.3. Obtaining your cluster ID
When providing information to Red Hat Support, it is helpful to provide the unique identifier for your cluster. You can have your cluster ID autofilled by using the OpenShift Container Platform web console. You can also manually obtain your cluster ID by using the web console or the OpenShift CLI (oc
).
Prerequisites
-
Access to the cluster as a user with the
cluster-admin
role. -
Access to the web console or the OpenShift CLI (
oc
) installed.
Procedure
To open a support case and have your cluster ID autofilled using the web console:
-
From the toolbar, navigate to (?) Help
Open Support Case. - The 'Cluster ID' value is autofilled.
-
From the toolbar, navigate to (?) Help
To manually obtain your cluster ID using the web console:
-
Navigate to Home
Dashboards Overview. - The value is available in the Cluster ID field of the Details section.
-
Navigate to Home
To obtain your cluster ID using the OpenShift CLI (
oc
), run the following command:$ oc get clusterversion -o jsonpath='{.items[].spec.clusterID}{"\n"}'