Collecting logging data for Red Hat Support

    The tool enables you to collect diagnostic information for project-level resources, cluster-level resources, and each of the OpenShift Logging components.

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

    The oc adm must-gather CLI command collects the information from your cluster that is most likely needed for debugging issues.

    For your OpenShift Logging environment, must-gather collects the following information:

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

    • OpenShift Logging resources in the openshift-logging and 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.

    • OpenShift Logging and Elasticsearch must be installed.

    You can use the oc adm must-gather CLI command to collect information about your OpenShift Logging environment.

    Procedure

    1. Run the oc adm must-gather command against the OpenShift Logging image:

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

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

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