:_mod-docs-content-type: REFERENCE
[id="virt-runbooks"]
= {VirtProductName} runbooks
include::_attributes/common-attributes.adoc[]
:context: virt-runbooks

toc::[]

:!virt-runbooks:
[role="_abstract"]
To diagnose and resolve {VirtProductName} alerts, you can use the {VirtProductName} Operator runbooks. These guides help ensure you can effectively troubleshoot cluster issues and restore system health.

[NOTE]
====
Runbooks for the {VirtProductName} Operator are maintained in the link:https://github.com/openshift/runbooks/tree/master/alerts/openshift-virtualization-operator[openshift/runbooks] Git repository, and you can view them on GitHub. 
====

[id="virt-runbooks-supported-table"]
[cols="1m,1"]
.Runbooks for {VirtProductName} alerts
|===
| Alert | GitHub link

| CDIDataImportCronOutdated
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIDataImportCronOutdated.md[Runbook]

| CDIDataVolumeUnusualRestartCount
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIDataVolumeUnusualRestartCount.md[Runbook]

| CDIDefaultStorageClassDegraded
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIDefaultStorageClassDegraded.md[Runbook]

| CDIMultipleDefaultVirtStorageClasses
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIMultipleDefaultVirtStorageClasses.md[Runbook]

| CDINoDefaultStorageClass
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDINoDefaultStorageClass.md[Runbook]

| CDINotReady
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDINotReady.md[Runbook]

| CDIOperatorDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIOperatorDown.md[Runbook]

| CDIStorageProfilesIncomplete
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIStorageProfilesIncomplete.md[Runbook]

| CnaoDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CnaoDown.md[Runbook]

| CnaoNMstateMigration
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CnaoNmstateMigration.md[Runbook]

| DeprecatedMachineType
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/DeprecatedMachineType.md[Runbook]

| GuestFilesystemAlmostOutOfSpace
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/GuestFilesystemAlmostOutOfSpace.md[Runbook]

| GuestVCPUQueueHighCritical
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/GuestVCPUQueueHighCritical.md[Runbook]

| GuestVCPUQueueHighWarning
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/GuestVCPUQueueHighWarning.md[Runbook]

| HAControlPlaneDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HAControlPlaneDown.md[Runbook]

| HCOGoldenImageWithNoArchitectureAnnotation
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOGoldenImageWithNoArchitectureAnnotation.md[Runbook]

| HCOGoldenImageWithNoSupportedArchitecture
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOGoldenImageWithNoSupportedArchitecture.md[Runbook]

| HCOInstallationIncomplete
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOInstallationIncomplete.md[Runbook]

| HCOMisconfiguredDescheduler
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOMisconfiguredDescheduler.md[Runbook]

| HCOMultiArchGoldenImagesDisabled
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOMultiArchGoldenImagesDisabled.md[Runbook]

| HCOOperatorConditionsUnhealthy
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOOperatorConditionsUnhealthy.md[Runbook]

| HighNodeCPUFrequency
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HighNodeCPUFrequency.md[Runbook]

| HPPNotReady
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HPPNotReady.md[Runbook]

| HPPOperatorDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HPPOperatorDown.md[Runbook]

| HPPSharingPoolPathWithOS
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HPPSharingPoolPathWithOS.md[Runbook]

| HighCPUWorkload
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HighCPUWorkload.md[Runbook]

| KubemacpoolDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubemacpoolDown.md[Runbook]

| KubeVirtCRModified
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtCRModified.md[Runbook]

| KubeVirtDeprecatedAPIRequested
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtDeprecatedAPIRequested.md[Runbook]

| KubeVirtVMGuestMemoryAvailableLow
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtVMGuestMemoryAvailableLow.md[Runbook]

| KubeVirtVMGuestMemoryPressure
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtVMGuestMemoryPressure.md[Runbook]

| KubeVirtNoAvailableNodesToRunVMs
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtNoAvailableNodesToRunVMs.md[Runbook]

| KubeVirtVMIExcessiveMigrations
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtVMIExcessiveMigrations.md[Runbook]

| LowKVMNodesCount
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowKVMNodesCount.md[Runbook]

| LowReadyVirtControllersCount
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowReadyVirtControllersCount.md[Runbook]

| LowReadyVirtOperatorsCount
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowReadyVirtOperatorsCount.md[Runbook]

| LowVirtAPICount
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowVirtAPICount.md[Runbook]

| LowVirtControllersCount
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowVirtControllersCount.md[Runbook]

| LowVirtOperatorCount
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowVirtOperatorCount.md[Runbook]

| NetworkAddonsConfigNotReady
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NetworkAddonsConfigNotReady.md[Runbook]

| NoLeadingVirtOperator
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NoLeadingVirtOperator.md[Runbook]

| NoReadyVirtController
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NoReadyVirtController.md[Runbook]

| NoReadyVirtOperator
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NoReadyVirtOperator.md[Runbook]

| NodeNetworkInterfaceDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NodeNetworkInterfaceDown.md[Runbook]

| OrphanedVirtualMachineInstances
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/OrphanedVirtualMachineInstances.md[Runbook]

| OutdatedVirtualMachineInstanceWorkloads
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/OutdatedVirtualMachineInstanceWorkloads.md[Runbook]

| PersistentVolumeFillingUp
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/PersistentVolumeFillingUp.md[Runbook]

| SSPCommonTemplatesModificationReverted
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPCommonTemplatesModificationReverted.md[Runbook]

| SSPDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPDown.md[Runbook]

| SSPFailingToReconcile
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPFailingToReconcile.md[Runbook]

| SSPHighRateRejectedVms
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPHighRateRejectedVms.md[Runbook]

| SSPTemplateValidatorDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPTemplateValidatorDown.md[Runbook]

| UnsupportedHCOModification
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/UnsupportedHCOModification.md[Runbook]

| VirtAPIDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtAPIDown.md[Runbook]

| VirtApiRESTErrorsBurst
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtApiRESTErrorsBurst.md[Runbook]

| VirtControllerDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtControllerDown.md[Runbook]

| VirtControllerRESTErrorsBurst
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtControllerRESTErrorsBurst.md[Runbook]

| VirtHandlerDaemonSetRolloutFailing
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtHandlerDaemonSetRolloutFailing.md[Runbook]

| VirtHandlerRESTErrorsBurst
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtHandlerRESTErrorsBurst.md[Runbook]

| VirtLauncherPodsStuckFailed
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtLauncherPodsStuckFailed.md[Runbook]

| VirtOperatorDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtOperatorDown.md[Runbook]

| VirtOperatorRESTErrorsBurst
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtOperatorRESTErrorsBurst.md[Runbook]

| VirtualMachineStuckInUnhealthyState
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineStuckInUnhealthyState.md[Runbook]

| VirtualMachineStuckOnNode
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineStuckOnNode.md[Runbook]

| VMCannotBeEvicted
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VMCannotBeEvicted.md[Runbook]

| VMStorageClassWarning
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VMStorageClassWarning.md[Runbook]
|===

[id="virt-runbooks-deprecated"]
== Runbooks for deprecated alerts

Deprecated alerts no longer report actual issues and you can safely ignore them.

.Runbooks for deprecated {VirtProductName} alerts
[id="virt-runbooks-deprecated-table"]
[cols="2m,1,1"]
|===
| Alert | GitHub link | Notes

| DuplicateWaspAgentDSDetected
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/DuplicateWaspAgentDSDetected.md[Runbook]
| -

| KubeMacPoolDuplicateMacsFound
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeMacPoolDuplicateMacsFound.md[Runbook]
| -

| VirtualMachineInstanceHasEphemeralHotplugVolume
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineInstanceHasEphemeralHotplugVolume.md[Runbook]
| -

| KubeVirtComponentExceedsRequestedCPU
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtComponentExceedsRequestedCPU.md[Runbook]
| -

| KubeVirtComponentExceedsRequestedMemory
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtComponentExceedsRequestedMemory.md[Runbook]
| -

| KubevirtVmHighMemoryUsage
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubevirtVmHighMemoryUsage.md[Runbook]
| -

| OperatorConditionsUnhealthy
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/OperatorConditionsUnhealthy.md[Runbook]
| -

| SingleStackIPv6Unsupported
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SingleStackIPv6Unsupported.md[Runbook]
| -

| SSPOperatorDown
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPOperatorDown.md[Runbook]
| -

| VirtApiRESTErrorsHigh
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtApiRESTErrorsHigh.md[Runbook]
| -

| VirtControllerRESTErrorsHigh
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtControllerRESTErrorsHigh.md[Runbook]
| -

| VirtHandlerRESTErrorsHigh
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtHandlerRESTErrorsHigh.md[Runbook]
| -

| VirtOperatorRESTErrorsHigh
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtOperatorRESTErrorsHigh.md[Runbook]
| -

| VirtualMachineCRCErrors
| link:https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineCRCErrors.md[Runbook]
| Renamed to `VMStorageClassWarning`.
|===
