:_mod-docs-content-type: ASSEMBLY
include::_attributes/common-attributes.adoc[]
[id="virt-collecting-virt-data"]
= Collecting data for Red{nbsp}Hat Support
:context: virt-collecting-virt-data

toc::[]

[role="_abstract"]
When you submit a support case to Red{nbsp}Hat Support, it is helpful to provide debugging information for {product-title} and {VirtProductName}.

You can use the following tools to collect debugging information:

// must-gather not supported for ROSA/OSD, per Dustin Row
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
must-gather tool::
The `must-gather` tool collects diagnostic information, including resource definitions and service logs.
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]

Prometheus::
Prometheus is a time-series database and a rule evaluation engine for metrics. Prometheus sends alerts to Alertmanager for processing.

Alertmanager::
The Alertmanager service handles alerts received from Prometheus. The Alertmanager is also responsible for sending the alerts to external notification systems.
//link needs to be added for HCP when available

include::modules/virt-collecting-data-about-your-environment.adoc[leveloffset=+1]

include::modules/virt-collecting-data-about-vms.adoc[leveloffset=+1]

// must-gather not supported for ROSA/OSD, per Dustin Row
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
include::modules/virt-using-virt-must-gather.adoc[leveloffset=+1]

include::modules/virt-must-gather-options.adoc[leveloffset=+2]

endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]

include::modules/virt-generating-a-vm-memory-dump.adoc[leveloffset=+1]

ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp,openshift-origin[]
include::modules/about-self-service-tsr.adoc[leveloffset=+1]
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp,openshift-origin[]

[role="_additional-resources"]
[id="additional-resources_{context}"]
== Additional resources
* xref:../../virt/support/virt-support-overview.adoc#virt-support-overview[VM support overview]
* link:https://access.redhat.com/solutions/2112[How to provide log files to Red Hat Support (Red Hat Knowledgebase)]
ifndef::openshift-dedicated,openshift-rosa-hcp,openshift-rosa[]
* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/latest/html/about_monitoring/about-ocp-monitoring[About {product-title} monitoring]
endif::openshift-dedicated,openshift-rosa-hcp,openshift-rosa[]
ifdef::openshift-dedicated,openshift-rosa[]
* xref:../../observability/monitoring/about-ocp-monitoring/about-ocp-monitoring.adoc#about-ocp-monitoring[About {product-title} monitoring]
endif::openshift-dedicated,openshift-rosa[]
* xref:../../virt/managing_vms/virt-installing-qemu-guest-agent.adoc#virt-installing-qemu-guest-agent-on-linux-vm_virt-installing-qemu-guest-agent[Installing the QEMU guest agent on a Linux VM]
* xref:../../virt/managing_vms/virt-install-virtio-drivers-on-windows-vms.adoc#virt-installing-virtio-drivers-existing-windows_virt-install-virtio-drivers-on-windows-vms[Installing VirtIO drivers from a SATA CD drive on an existing Windows VM]
* xref:../../virt/managing_vms/virt-accessing-vm-consoles.adoc#virt-connecting-desktop-viewer-web_virt-accessing-vm-consoles[Connect to the desktop viewer by using the web console]
* xref:../../virt/support/virt-collecting-virt-data.adoc#virt-generating-a-vm-memory-dump_virt-collecting-virt-data[Collect memory dumps from VMs]
* xref:../../support/getting-support.adoc#support-submitting-a-case_getting-support[Submitting a support case]
* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/latest/html/configuring_user_workload_monitoring/storing-and-recording-data-uwm#modifying-retention-time-and-size-for-prometheus-metrics-data_storing-and-recording-data-uwm[Modifying retention time and size for Prometheus metrics data]
* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/latest/html/configuring_user_workload_monitoring/storing-and-recording-data-uwm#modifying-retention-time-and-size-for-prometheus-metrics-data_storing-and-recording-data-uwm[Configuring the Alertmanager to capture relevant alerts and to send alert notifications to a dedicated mailbox]
* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/latest/html/configuring_core_platform_monitoring/storing-and-recording-data#modifying-retention-time-and-size-for-prometheus-metrics-data_storing-and-recording-data[Modifying retention time and size for Prometheus metrics data]
* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/latest/html/configuring_core_platform_monitoring/configuring-alerts-and-notifications[Configuring alerts and notifications]
* link:https://access.redhat.com/documentation/en-us/red_hat_openshift_data_foundation/latest/html-single/troubleshooting_openshift_data_foundation/index#downloading-log-files-and-diagnostic-information_rhodf[Downloading log files and diagnostic information]
* link:https://docs.redhat.com/en/documentation/monitoring_stack_for_red_hat_openshift/latest/html/accessing_metrics/accessing-metrics-as-an-administrator#querying-metrics-for-all-projects-with-mon-dashboard_accessing-metrics-as-an-administrator[Querying metrics for all projects with the monitoring dashboard]
* link:https://access.redhat.com/solutions/6957701[Installing the latest VirtIO drivers]
* link:https://github.com/volatilityfoundation/volatility3[Volatility3 tool]
* link:https://access.redhat.com/support/cases/#/case/list[Customer Support]
* link:https://redhat.atlassian.net/secure/CreateIssue.jspa[Create issue]
