// Module included in the following assemblies:
//
// * virt/support/virt-collecting-virt-data.adoc

:_mod-docs-content-type: PROCEDURE
[id="virt-collecting-data-about-your-environment_{context}"]
= Collecting data about your environment

[role="_abstract"]
Collecting data about your environment minimizes the time required to analyze and determine the root cause.

.Prerequisites
//link needs to be added for HCP when available
ifdef::openshift-dedicated,openshift-rosa[]
* You have set the retention time for Prometheus metrics data to a minimum of seven days.
* You have configured the Alertmanager to capture relevant alerts and to send alert notifications to a dedicated mailbox so that they can be viewed and persisted outside the cluster.
endif::openshift-dedicated,openshift-rosa[]

ifndef::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
* You have set the retention time for Prometheus metrics data to a minimum of seven days.
* You have configured the Alertmanager to capture relevant alerts and to send alert notifications to a dedicated mailbox so that they can be viewed and persisted outside the cluster.
endif::openshift-dedicated,openshift-rosa,openshift-rosa-hcp[]
* You have recorded the exact number of affected nodes and virtual machines.

.Procedure

// must-gather not supported for ROSA/OSD, per Dustin Row
ifndef::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
. Collect must-gather data for the cluster.
. Collect must-gather data for {rh-storage-first}, if necessary.
. Collect must-gather data for {VirtProductName}.
endif::openshift-rosa,openshift-dedicated,openshift-rosa-hcp[]
ifndef::openshift-rosa-hcp[]
. Collect Prometheus metrics for the cluster.
endif::openshift-rosa-hcp[]
//link needs to be added for HCP when available
