×

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

Runbooks for the OKD Virtualization Operator are maintained in the openshift/runbooks Git repository, and you can view them on GitHub.

Table 1. Runbooks for OKD Virtualization alerts
Alert GitHub link

CDIDataImportCronOutdated

Runbook

CDIDataVolumeUnusualRestartCount

Runbook

CDIDefaultStorageClassDegraded

Runbook

CDIMultipleDefaultVirtStorageClasses

Runbook

CDINoDefaultStorageClass

Runbook

CDINotReady

Runbook

CDIOperatorDown

Runbook

CDIStorageProfilesIncomplete

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

VMStorageClassWarning

Runbook

Runbooks for deprecated alerts

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

Table 2. Runbooks for deprecated OKD 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.