15장. Support
15.1. Support overview
Accelerate the resolution of cluster and virtual machine (VM) issues by using the integrated diagnostic tools and support provided by OpenShift Virtualization.
To gather debugging information, configure Prometheus and Alertmanager and collect must-gather data for OpenShift Container Platform and OpenShift Virtualization.
15.1.1. Opening a support case
Open a support case with Red Hat Support when you encounter an issue that requires immediate assistance.
15.1.1.1. Collecting data for Red Hat Support
Gather information about the issue affecting your environment to submit with your support case. This aids Red Hat Support in effectively diagnosing your issue.
Gather troubleshooting information by using the following tools:
- Configure Prometheus and Alertmanager.
-
Configure and use the
must-gathertool. -
Collect
must-gatherdata and memory dumps from VMs. -
Collect
must-gatherdata for OpenShift Container Platform and OpenShift Virtualization
15.1.1.2. Submitting a support case
Submit a support case to resolve a cluster issue that is affecting the ability of OpenShift Virtualization to function properly in your environment.
You can submit a support case to Red Hat Support by using the Customer Support page. Include data that you collected about your issue with your support request.
15.1.2. Creating a Jira issue
To report a bug, use the Red Hat Issue Router (RHIR), which is available in the Customer Portal Labs.
Procedure
- Access the RHIR.
- In the list of all OpenShift Virtualization components, find the component for which you want to report an issue.
- Click the Report a bug link of the component.
On the Create issue page, fill out the form:
- Complete the Summary and Description fields. In the Description field, include a detailed description of the issue.
Submit any collected troubleshooting information:
- Add any textual troubleshooting information, such as command outputs, in the Description field.
- Add troubleshooting files using the Attachment field.
- Click Create at the bottom of the page.
- Review the details of the bug you created.
15.1.3. Provide feedback on OpenShift Virtualization documentation
To report an error or request an enhancement in the documentation, log in to your Red Hat Jira account and submit an issue. If you do not have a Red Hat Jira account, you are prompted to create an account.
Procedure
- Create a Jira issue for OpenShift Virtualization and in the Component field, select CNV Documentation.
- Enter a brief description of the issue in the Summary.
- Provide a detailed description of the issue or requested enhancement in the Description. Include a URL to where the issue occurs in the documentation.
- Click Create.
15.1.4. Web console monitoring
Monitor cluster and virtual machine (VM) health with the OpenShift Container Platform web console.
The OpenShift Container Platform web console displays resource usage, alerts, events, and trends for your cluster and for OpenShift Virtualization components and resources.
| Page | Description |
|---|---|
| Overview page | Cluster details, status, alerts, inventory, and resource usage |
|
Virtualization | OpenShift Virtualization resources, usage, alerts, and status |
|
Virtualization | Top consumers of CPU, memory, and storage |
|
Virtualization | Progress of live migrations |
|
Virtualization | CPU, memory, and storage usage summary |
|
Virtualization | VM resource usage, storage, network, and migration |
|
Virtualization | List of VM events |
|
Virtualization | VM status conditions and volume snapshot status |
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}