---
title: OpenShift Virtualization runbooks
---

# OpenShift Virtualization runbooks {#virt-runbooks}

To diagnose and resolve OpenShift Virtualization alerts, you can use the OpenShift Virtualization Operator runbooks. These guides help ensure you can effectively troubleshoot cluster issues and restore system health.

> [!NOTE]
> Runbooks for the OpenShift Virtualization Operator are maintained in the [openshift/runbooks](https://github.com/openshift/runbooks/tree/master/alerts/openshift-virtualization-operator) Git repository, and you can view them on GitHub.

**Runbooks for OpenShift Virtualization alerts**

| Alert | GitHub link |
| --- | --- |
| CDIDataImportCronOutdated | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIDataImportCronOutdated.md) |
| CDIDataVolumeUnusualRestartCount | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIDataVolumeUnusualRestartCount.md) |
| CDIDefaultStorageClassDegraded | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIDefaultStorageClassDegraded.md) |
| CDIMultipleDefaultVirtStorageClasses | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIMultipleDefaultVirtStorageClasses.md) |
| CDINoDefaultStorageClass | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDINoDefaultStorageClass.md) |
| CDINotReady | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDINotReady.md) |
| CDIOperatorDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIOperatorDown.md) |
| CDIStorageProfilesIncomplete | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CDIStorageProfilesIncomplete.md) |
| ClusterVMPanicDetected | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/ClusterVMPanicDetected.md) |
| CnaoDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CnaoDown.md) |
| CnaoNMstateMigration | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/CnaoNmstateMigration.md) |
| DeprecatedMachineType | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/DeprecatedMachineType.md) |
| GuestFilesystemAlmostOutOfSpace | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/GuestFilesystemAlmostOutOfSpace.md) |
| GuestVCPUQueueHighCritical | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/GuestVCPUQueueHighCritical.md) |
| GuestVCPUQueueHighWarning | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/GuestVCPUQueueHighWarning.md) |
| HAControlPlaneDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HAControlPlaneDown.md) |
| HCOGoldenImageWithNoArchitectureAnnotation | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOGoldenImageWithNoArchitectureAnnotation.md) |
| HCOGoldenImageWithNoSupportedArchitecture | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOGoldenImageWithNoSupportedArchitecture.md) |
| HCOInstallationIncomplete | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOInstallationIncomplete.md) |
| HCOMisconfiguredDescheduler | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOMisconfiguredDescheduler.md) |
| HCOMultiArchGoldenImagesDisabled | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOMultiArchGoldenImagesDisabled.md) |
| HCOOperatorConditionsUnhealthy | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HCOOperatorConditionsUnhealthy.md) |
| HighNodeCPUFrequency | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HighNodeCPUFrequency.md) |
| HPPNotReady | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HPPNotReady.md) |
| HPPOperatorDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HPPOperatorDown.md) |
| HPPSharingPoolPathWithOS | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HPPSharingPoolPathWithOS.md) |
| HighCPUWorkload | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/HighCPUWorkload.md) |
| KubemacpoolDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubemacpoolDown.md) |
| KubeVirtCRModified | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtCRModified.md) |
| KubeVirtDeprecatedAPIRequested | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtDeprecatedAPIRequested.md) |
| KubeVirtVMGuestMemoryAvailableLow | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtVMGuestMemoryAvailableLow.md) |
| KubeVirtVMGuestMemoryPressure | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtVMGuestMemoryPressure.md) |
| KubeVirtNoAvailableNodesToRunVMs | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtNoAvailableNodesToRunVMs.md) |
| KubeVirtVMIExcessiveMigrations | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtVMIExcessiveMigrations.md) |
| LowKVMNodesCount | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowKVMNodesCount.md) |
| LowReadyVirtControllersCount | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowReadyVirtControllersCount.md) |
| LowReadyVirtOperatorsCount | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowReadyVirtOperatorsCount.md) |
| LowVirtAPICount | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowVirtAPICount.md) |
| LowVirtControllersCount | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowVirtControllersCount.md) |
| LowVirtOperatorCount | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/LowVirtOperatorCount.md) |
| NetworkAddonsConfigNotReady | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NetworkAddonsConfigNotReady.md) |
| NoLeadingVirtOperator | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NoLeadingVirtOperator.md) |
| NoReadyVirtController | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NoReadyVirtController.md) |
| NoReadyVirtOperator | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NoReadyVirtOperator.md) |
| NodeNetworkInterfaceDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/NodeNetworkInterfaceDown.md) |
| OrphanedVirtualMachineInstances | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/OrphanedVirtualMachineInstances.md) |
| OutdatedVirtualMachineInstanceWorkloads | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/OutdatedVirtualMachineInstanceWorkloads.md) |
| PersistentVolumeFillingUp | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/PersistentVolumeFillingUp.md) |
| SSPCommonTemplatesModificationReverted | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPCommonTemplatesModificationReverted.md) |
| SSPDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPDown.md) |
| SSPFailingToReconcile | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPFailingToReconcile.md) |
| SSPHighRateRejectedVms | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPHighRateRejectedVms.md) |
| SSPTemplateValidatorDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPTemplateValidatorDown.md) |
| UnsupportedHCOModification | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/UnsupportedHCOModification.md) |
| VirtAPIDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtAPIDown.md) |
| VirtApiRESTErrorsBurst | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtApiRESTErrorsBurst.md) |
| VirtControllerDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtControllerDown.md) |
| VirtControllerRESTErrorsBurst | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtControllerRESTErrorsBurst.md) |
| VirtHandlerDaemonSetRolloutFailing | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtHandlerDaemonSetRolloutFailing.md) |
| VirtHandlerRESTErrorsBurst | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtHandlerRESTErrorsBurst.md) |
| VirtLauncherPodsStuckFailed | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtLauncherPodsStuckFailed.md) |
| VirtOperatorDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtOperatorDown.md) |
| VirtOperatorRESTErrorsBurst | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtOperatorRESTErrorsBurst.md) |
| VirtualMachineInstanceHasEphemeralHotplugVolume | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineInstanceHasEphemeralHotplugVolume.md) |
| VirtualMachineStuckInUnhealthyState | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineStuckInUnhealthyState.md) |
| VirtualMachineStuckOnNode | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineStuckOnNode.md) |
| VMCannotBeEvicted | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VMCannotBeEvicted.md) |
| VMNonRecoverableOSPanic | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VMNonRecoverableOSPanic.md) |
| VMStorageClassWarning | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VMStorageClassWarning.md) |

## Runbooks for deprecated alerts {#virt-runbooks-deprecated}

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

**Runbooks for deprecated OpenShift Virtualization alerts**

| Alert | GitHub link | Notes |
| --- | --- | --- |
| DuplicateWaspAgentDSDetected | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/DuplicateWaspAgentDSDetected.md) | - |
| KubeMacPoolDuplicateMacsFound | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeMacPoolDuplicateMacsFound.md) | - |
| KubeVirtComponentExceedsRequestedCPU | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtComponentExceedsRequestedCPU.md) | - |
| KubeVirtComponentExceedsRequestedMemory | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubeVirtComponentExceedsRequestedMemory.md) | - |
| KubevirtVmHighMemoryUsage | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/KubevirtVmHighMemoryUsage.md) | - |
| OperatorConditionsUnhealthy | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/OperatorConditionsUnhealthy.md) | - |
| SingleStackIPv6Unsupported | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SingleStackIPv6Unsupported.md) | - |
| SSPOperatorDown | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/SSPOperatorDown.md) | - |
| VirtApiRESTErrorsHigh | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtApiRESTErrorsHigh.md) | - |
| VirtControllerRESTErrorsHigh | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtControllerRESTErrorsHigh.md) | - |
| VirtHandlerRESTErrorsHigh | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtHandlerRESTErrorsHigh.md) | - |
| VirtOperatorRESTErrorsHigh | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtOperatorRESTErrorsHigh.md) | - |
| VirtualMachineCRCErrors | [Runbook](https://github.com/openshift/runbooks/blob/master/alerts/openshift-virtualization-operator/VirtualMachineCRCErrors.md) | Renamed to `VMStorageClassWarning`. |