OpenShift Virtualization 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 Git repository, and you can view them on GitHub.
Runbooks for OpenShift Virtualization alerts
| Alert | GitHub link |
|---|---|
| CDIDataImportCronOutdated | Runbook |
| CDIDataVolumeUnusualRestartCount | Runbook |
| CDIDefaultStorageClassDegraded | Runbook |
| CDIMultipleDefaultVirtStorageClasses | Runbook |
| CDINoDefaultStorageClass | Runbook |
| CDINotReady | Runbook |
| CDIOperatorDown | Runbook |
| CDIStorageProfilesIncomplete | Runbook |
| ClusterVMPanicDetected | Runbook |
| CnaoDown | Runbook |
| CnaoNMstateMigration | Runbook |
| DeprecatedMachineType | Runbook |
| GuestFilesystemAlmostOutOfSpace | Runbook |
| GuestVCPUQueueHighCritical | Runbook |
| GuestVCPUQueueHighWarning | Runbook |
| HAControlPlaneDown | Runbook |
| HCOGoldenImageWithNoArchitectureAnnotation | Runbook |
| HCOGoldenImageWithNoSupportedArchitecture | Runbook |
| HCOInstallationIncomplete | Runbook |
| HCOMisconfiguredDescheduler | Runbook |
| HCOMultiArchGoldenImagesDisabled | Runbook |
| HCOOperatorConditionsUnhealthy | Runbook |
| HighNodeCPUFrequency | Runbook |
| HPPNotReady | Runbook |
| HPPOperatorDown | Runbook |
| HPPSharingPoolPathWithOS | Runbook |
| HighCPUWorkload | Runbook |
| KubemacpoolDown | Runbook |
| KubeVirtCRModified | Runbook |
| KubeVirtDeprecatedAPIRequested | Runbook |
| KubeVirtVMGuestMemoryAvailableLow | Runbook |
| KubeVirtVMGuestMemoryPressure | Runbook |
| KubeVirtNoAvailableNodesToRunVMs | Runbook |
| KubeVirtVMIExcessiveMigrations | Runbook |
| LowKVMNodesCount | Runbook |
| LowReadyVirtControllersCount | Runbook |
| LowReadyVirtOperatorsCount | Runbook |
| LowVirtAPICount | Runbook |
| LowVirtControllersCount | Runbook |
| LowVirtOperatorCount | Runbook |
| NetworkAddonsConfigNotReady | Runbook |
| NoLeadingVirtOperator | Runbook |
| NoReadyVirtController | Runbook |
| NoReadyVirtOperator | Runbook |
| NodeNetworkInterfaceDown | Runbook |
| OrphanedVirtualMachineInstances | Runbook |
| OutdatedVirtualMachineInstanceWorkloads | Runbook |
| PersistentVolumeFillingUp | Runbook |
| SSPCommonTemplatesModificationReverted | Runbook |
| SSPDown | Runbook |
| SSPFailingToReconcile | Runbook |
| SSPHighRateRejectedVms | Runbook |
| SSPTemplateValidatorDown | Runbook |
| UnsupportedHCOModification | Runbook |
| VirtAPIDown | Runbook |
| VirtApiRESTErrorsBurst | Runbook |
| VirtControllerDown | Runbook |
| VirtControllerRESTErrorsBurst | Runbook |
| VirtHandlerDaemonSetRolloutFailing | Runbook |
| VirtHandlerRESTErrorsBurst | Runbook |
| VirtLauncherPodsStuckFailed | Runbook |
| VirtOperatorDown | Runbook |
| VirtOperatorRESTErrorsBurst | Runbook |
| VirtualMachineInstanceHasEphemeralHotplugVolume | Runbook |
| VirtualMachineStuckInUnhealthyState | Runbook |
| VirtualMachineStuckOnNode | Runbook |
| VMCannotBeEvicted | Runbook |
| VMNonRecoverableOSPanic | Runbook |
| VMStorageClassWarning | Runbook |
Runbooks for deprecated alerts
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 | - |
| KubeMacPoolDuplicateMacsFound | Runbook | - |
| KubeVirtComponentExceedsRequestedCPU | Runbook | - |
| KubeVirtComponentExceedsRequestedMemory | Runbook | - |
| KubevirtVmHighMemoryUsage | Runbook | - |
| OperatorConditionsUnhealthy | Runbook | - |
| SingleStackIPv6Unsupported | Runbook | - |
| SSPOperatorDown | Runbook | - |
| VirtApiRESTErrorsHigh | Runbook | - |
| VirtControllerRESTErrorsHigh | Runbook | - |
| VirtHandlerRESTErrorsHigh | Runbook | - |
| VirtOperatorRESTErrorsHigh | Runbook | - |
| VirtualMachineCRCErrors | Runbook | Renamed to VMStorageClassWarning. |