此内容没有您所选择的语言版本。
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
Secrets
andConfigMaps
. - 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
openstack
andopenstack-operators
namespaces. - RHOCP Events that are related to the RHOSO namespaces.
Prerequisites
-
Access to the cluster as a user with
cluster-admin
privileges.
Procedure
-
Navigate to the directory where you want to store the
must-gather
data. Pass one or more images or image streams to the
must-gather
tool 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.