KubeVirt Special Agent

Community MKP for monitoring KubeVirt virtual machines and platform health with Checkmk.

This package adds a Checkmk special agent that collects data from the Kubernetes/KubeVirt API and Prometheus metrics. It discovers KubeVirt virtual machines as piggyback hosts and creates VM-level services for CPU, memory, disks, network interfaces, placement and resource information.

It is intended for generic KubeVirt environments. For Harvester / SUSE Virtualization platform, Longhorn and node monitoring, use the separate checkmk-harvester extension.

What you get

• KubeVirt VM discovery as Checkmk piggyback hosts
• VM CPU monitoring
• VM memory monitoring
• VM disk monitoring
• VM network monitoring
• VM interface information
• VM placement information
• VM resource/request information
• VM info and lifecycle state
• KubeVirt platform health checks on the source host
• KubeVirt component health
• KubeVirt version information
• KubeVirt controller status
• KubeVirt migrations
• KubeVirt VMI phase summary
• KubeVirt workqueue monitoring

Created services

The package can create VM services such as:

• VM CPU
• VM memory
• VM disk disk-0
• VM network default
• VM interfaces
• VM placement
• VM resources
• VM info

On the source host, it can create services such as:

• KubeVirt component health
• KubeVirt controller status
• KubeVirt migrations
• KubeVirt version
• KubeVirt VM lifecycle
• KubeVirt VMI phases
• KubeVirt workqueues

The exact number of services depends on the number of VMs, VM disks, VM networks and metrics exposed by the monitored KubeVirt environment.

Requirements

• Checkmk 2.5
• Kubernetes API access
• Read access to KubeVirt resources
• Access to a Prometheus endpoint exposing KubeVirt metrics
• A Kubernetes service account / bearer token for the special agent

Installation

Install via mkp add / mkp enable, or use Setup > Extension packages.

After installation, configure the KubeVirt special agent rule with:

• Kubernetes API endpoint
• Bearer token from the Checkmk password store
• Prometheus endpoint
• Cluster name
• Optional TLS certificate verification settings

A minimal Kubernetes RBAC example is included in the repository under docs/kubevirt_rbac.yaml.

Notes

This extension monitors KubeVirt from the platform side. It does not replace guest operating system monitoring inside the virtual machines. For guest OS metrics such as filesystems, processes, services or package inventory, install the normal Checkmk agent inside the VM.