KubeVirt Controller integration metrics

The official Datadog integration for monitoring KubeVirt Controller. It collects 34 metrics.

Definitions as of 2026-04-15

Official summary

Collect key metrics to monitor the health of your KubeVirt Controller service.

Metric types

count (occurrences in the interval): 22
gauge (value at a point in time): 12

Metrics

Descriptions are the official definitions, unedited.

Metric	Type	Unit
`kubevirt_controller.can_connect`Value of 1 if the agent can connect to the KubeVirt Controller, and 0 otherwise.	gauge	-
`kubevirt_controller.virt_controller.leading_status`Indication for an operating virt-controller.	gauge	-
`kubevirt_controller.virt_controller.ready_status`Indication for a virt-controller that is ready to take the lead.	gauge	-
`kubevirt_controller.vm.error_status_last_transition_timestamp_seconds.count`Virtual Machine last transition timestamp to error status.	count	second
`kubevirt_controller.vm.migrating_status_last_transition_timestamp_seconds.count`Virtual Machine last transition timestamp to migrating status.	count	second
`kubevirt_controller.vm.non_running_status_last_transition_timestamp_seconds.count`Virtual Machine last transition timestamp to paused/stopped status.	count	second
`kubevirt_controller.vm.running_status_last_transition_timestamp_seconds.count`Virtual Machine last transition timestamp to running status.	count	second
`kubevirt_controller.vm.starting_status_last_transition_timestamp_seconds.count`Virtual Machine last transition timestamp to starting status.	count	second
`kubevirt_controller.vmi.migrations_in_pending_phase`Number of current pending migrations.	gauge	-
`kubevirt_controller.vmi.migrations_in_running_phase`Number of current running migrations.	gauge	-
`kubevirt_controller.vmi.migrations_in_scheduling_phase`Number of current scheduling migrations.	gauge	-
`kubevirt_controller.vmi.non_evictable`Indication for a VirtualMachine that its eviction strategy is set to Live Migration but is not migratable.	gauge	-
`kubevirt_controller.vmi.number_of_outdated`Indication for the total number of VirtualMachineInstance workloads that are not running within the most up-to-date version of the virt-launcher environment.	gauge	-
`kubevirt_controller.vmi.phase_count`Sum of VMIs per phase and node. phase can be one of the following: [Pending, Scheduling, Scheduled, Running, Succeeded, Failed, Unknown].	gauge	-
`kubevirt_controller.vmi.phase_transition_time_from_creation_seconds.bucket`Histogram of VM phase transitions duration from creation time in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_from_creation_seconds.count`Histogram of VM phase transitions duration from creation time in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_from_creation_seconds.sum`Histogram of VM phase transitions duration from creation time in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_from_deletion_seconds.bucket`Histogram of VM phase transitions duration from deletion time in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_from_deletion_seconds.count`Histogram of VM phase transitions duration from deletion time in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_from_deletion_seconds.sum`Histogram of VM phase transitions duration from deletion time in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_seconds.bucket`Histogram of VM phase transitions duration between different phases in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_seconds.count`Histogram of VM phase transitions duration between different phases in seconds.	count	second
`kubevirt_controller.vmi.phase_transition_time_seconds.sum`Histogram of VM phase transitions duration between different phases in seconds.	count	second
`kubevirt_controller.workqueue.adds.count`Total number of adds handled by workqueue	count	item
`kubevirt_controller.workqueue.depth`Current depth of workqueue	gauge	item
`kubevirt_controller.workqueue.longest_running_processor_seconds`How many seconds has the longest running processor for workqueue been running.	gauge	second
`kubevirt_controller.workqueue.queue_duration_seconds.bucket`How long an item stays in workqueue before being requested.	count	second
`kubevirt_controller.workqueue.queue_duration_seconds.count`How long an item stays in workqueue before being requested.	count	second
`kubevirt_controller.workqueue.queue_duration_seconds.sum`How long an item stays in workqueue before being requested.	count	second
`kubevirt_controller.workqueue.retries.count`Total number of retries handled by workqueue.	count	-
`kubevirt_controller.workqueue.unfinished_work_seconds`How many seconds of work has done that is in progress and hasn't been observed by work_duration. Large values indicate stuck threads. One can deduce the number of stuck threads by observing the rate at which this increases.	gauge	second
`kubevirt_controller.workqueue.work_duration_seconds.bucket`How long in seconds processing an item from workqueue takes.	count	second
`kubevirt_controller.workqueue.work_duration_seconds.count`How long in seconds processing an item from workqueue takes.	count	second
`kubevirt_controller.workqueue.work_duration_seconds.sum`How long in seconds processing an item from workqueue takes.	count	second

Official documentation

Official documentation for the KubeVirt Controller integration

Metric names and descriptions are the official Datadog integration definitions (Copyright Datadog, Inc., BSD-3-Clause), reproduced unedited. The full license terms are on the About page.

Official summary

Metric types

Metrics

Official documentation

Related products

Other Kubernetes integrations