Ce contenu n'est pas disponible dans la langue sélectionnée.
Chapter 9. Collecting diagnostic information for Support
Use the Red Hat OpenStack Services on OpenShift (RHOSO) must-gather tool to collect diagnostic information about your Red Hat OpenShift Container Platform (RHOCP) cluster, including the RHOSO control plane and the deployed RHOSO services. Use the RHOCP sosreport tool to collect diagnostic information about your RHOSO data plane.
9.1. Collecting data on the RHOSO control plane
You can use the Red Hat OpenStack Services on OpenShift (RHOSO) must-gather tool to collect the following information about your Red Hat OpenShift Container Platform (RHOCP) cluster to troubleshoot service failures:
- The RHOSO control plane service logs.
-
The configuration of RHOSO control plane services, such as the RHOCP
SecretsandConfigMaps. - Status of the services that are deployed in the RHOSO control plane.
- The RHOSO generated Custom Resource Definitions (CRDs).
- The RHOSO control plane applied Custom Resources (CRs).
-
The
openstackandopenstack-operatorsnamespaces. - RHOCP Events that are related to the RHOSO namespaces.
Prerequisites
-
Access to the cluster as a user with
cluster-adminprivileges.
Procedure
-
Navigate to the directory where you want to store the
must-gatherdata. Pass one or more images or image streams to the
must-gathertool to specify the data to collect. For example, the following command gathers both the default cluster data and the information that is specific to the deployed RHOSO control plane:$ oc adm must-gather \ --image-stream=openshift/must-gather \ 1 --image=registry.redhat.io/openstack-k8s-operators/openstack-must-gather 2
This command creates a local directory that stores the logs, services configuration, and the status of the RHOSO control plane services.
9.2. Collecting data on the RHOSO data plane nodes
The data plane nodes are RHEL nodes where the Compute service (nova) runs, and the Ceph daemons in an HCI environment. The must-gather tool collects the Red Hat OpenShift Container Platform (RHOCP) information that is generated in the control plane, but it does not gather the logs for the data plane nodes. To diagnose and troubleshoot issues on the data plane, Red Hat Support requires regular SOS reports to gather the data of the services that are deployed in the data plane nodes.
For information on how to use the SOS report tool, see Getting the most from your Support experience.
