This is a cache of https://docs.okd.io/4.9/logging/troubleshooting/cluster-logging-must-gather.html. It is a snapshot of the page at 2024-11-21T23:35:47.406+0000.
Collecting <strong>logging</strong> data for Red Hat Support - Troubleshooting <strong>logging</strong> | <strong>logging</strong> | OKD 4.9
  1. Documentation
×

Collecting logging data for Red Hat Support

When opening a support case, it is helpful to provide debugging information about your cluster to Red Hat Support.

The must-gather tool enables you to collect diagnostic information for project-level resources, cluster-level resources, and each of the logging subsystem components.

For prompt support, supply diagnostic information for both OKD and OpenShift logging.

Do not use the hack/logging-dump.sh script. The script is no longer supported and does not collect data.

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.

For your logging subsystem, must-gather collects the following information:

  • Project-level resources, including pods, configuration maps, service accounts, roles, role bindings, and events at the project level

  • Cluster-level resources, including nodes, roles, and role bindings at the cluster level

  • OpenShift logging resources in the openshift-logging and openshift-operators-redhat namespaces, including health status for the log collector, the log store, and the log visualizer

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.

Prerequisites

  • The logging subsystem and Elasticsearch must be installed.

Collecting OpenShift logging data

You can use the oc adm must-gather CLI command to collect information about your logging subsystem.

Procedure

To collect logging subsystem information with must-gather:

  1. Navigate to the directory where you want to store the must-gather information.

  2. Run the oc adm must-gather command against the OpenShift logging image:

    $ oc adm must-gather --image=quay.io/openshift/origin-cluster-logging-operator

    The must-gather tool creates a new directory that starts with must-gather.local within the current directory. For example: must-gather.local.4157245944708210408.

  3. Create a compressed file from the must-gather directory that was just created. For example, on a computer that uses a Linux operating system, run the following command:

    $ tar -cvaf must-gather.tar.gz must-gather.local.4157245944708210408

  4. Attach the compressed file to your support case on the Red Hat Customer Portal.