KVM metrics

The following metrics are available for Kernel-based Virtual Machine (KVM) systems:

KVM Host Configuration

The KVM Host Configuration metric group provides configuration information for KVM hosts.

Metric and available units	Description
Threads per Core	The number of threads per CPU core.
Cores per Socket	The number of CPU cores per socket.
Sockets per Node	The number of CPU sockets per node.
Nodes	The number of NUMA cells on this host.
Clock Rate	The expected CPU frequency in MHz.
Total Memory	The memory size in kilobytes (actual physical RAM on the machine).
Active CPUs	The number of active CPUs.
CPU Model	A string indicating the CPU type (for example, i686).
Hypervisor Version	The hypervisor version number.
API Version	The version of the API used by the virtualization layer.
Library Version	The version of the libvirt library used on this host.

The KVM Domain NUMA Configuration metric group provides KVM-specific configuration information for NUMA nodes.

Metric	Description
Domain Name	The name given to the VM when it was created. This name is different from the network name.
Domain ID	A unique numerical identifier that was assigned to the VM when it was created within the KVM host.
Memory Access	Indicates whether the memory is to be mapped as shared or private. This access is valid only for hugepages-backed memory and nvdimm modules.
Node ID	The ID of NUMA node.
NUMA Node ID	The ID that represents association of a specific processor with a particular NUMA node.
Number of Processors	Number of CPUs that are installed in the NUMA node.
Total Memory	Total amount of RAM that is installed in the NUMA node.

The KVM Domain Configuration metric group provides system configuration information for each KVM VM.

Metric and available units	Description
Domain Name	The name given to the VM when it was created. This name is different from the network name.
Domain ID	A unique numerical identifier that was assigned to the VM when it was created within the KVM host.
Available VCPUs	The number of virtual CPUs assigned to the VM.
Online VCPUs	The number of virtual CPUs currently in use by the VM.
Total Memory	The maximum amount of memory, in kilobytes, available to the VM.
State	The run state of the VM.
UUID	The unique hexadecimal machine identifier assigned to the VM.
MAC Address	The 48-bit address of the network adapter card.
Credit Weight	A numerical value representing the CPU time allocation assigned to the domain.
Credit Cap	A numerical value representing the maximum CPU time the domain can use.
Operating System	The name of the operating system that is running on the VM.

The KVM Domain Statistics metric group provides memory- and CPU-related information for each KVM VM.

Metric and available units	Description
Domain Name	The name given to the VM when it was created. This name is different from the network name.
Domain ID	A unique numerical identifier that was assigned to the VM when it was created within the KVM host.
Total Memory¹	The maximum amount of memory, in kilobytes, available to the VM.
Free Memory^₁	The amount of memory still available to the VM; this is a calculated field.
CPU Time	The amount of time, in seconds, the CPU was used by the VM.
Memory Utilization	The percentage of physical memory being used by the VM.

¹ - The metric is collected only when the dommemstat collection is enabled by running the virsh command. For information about running this command, see Collecting memory utilization metrics from KVM virtual machines.

The KVM VCPU Statistics metric group provides virtual CPU information for each KVM VM.

Metric and available units	Description
VCPU ID	The virtual CPU identifier.
Domain ID	A unique numerical identifier that was assigned to the VM when it was created within the KVM host.
Domain Name	The name given to the VM when it was created, it has no real correlation to the network name.
CPU Time	T The amount of time, in seconds, the CPU was used by the VM.
Real CPU ID	The physical CPU identifier.
State	The state of the virtual CPU.

The KVM Disk Statistics metric group provides disk-related information for each KVM VM.

Metric and available units	Description
Disk Name	The name of the disk, as reported by the KVM host.
Domain ID	A unique numerical identifier that was assigned to the VM when it was created within the KVM host.
Domain Name	The name given to the VM when it was created. This name is different from the network name.
Read Requests	The number of times data was written to disk.
Write Requests	The number of times data was read from the disk.
Read Bytes	The average number of bytes read from the disk.
Write Bytes	The average number of bytes written to the disk.
Total Requests	The total number of times data was written to and read from the disk.
Total I/O	The total number of bytes written to and read from the disk.
Total I/O Kbs	Expressed in kilobytes per second, the rate at which IO requests were generated by the VM.

The KVM Network Interface Statistics metric group provides network-related information for each KVM VM.

Metric and available unit	Description
Interface Name	The Network Interface name, as reported by the KVM host.
Domain ID	A unique numerical identifier that was assigned to the VM when it was created within the KVM host.
Domain Name	The name given to the VM when it was created. This name is different from the network name.
MAC Address	The 48-bit address of the network adapter card.
In Packets	The number of packets received.
Out Packets	The number of packets sent.
In Errors	The number of input errors.
Out Errors	The number of output errors.
In Bytes	The number of bytes received by the network interface card.
Out Bytes	The number of bytes transferred by the network interface card.
In Drop	The number of incoming packets dropped.
Out Drop	The number of outgoing packets dropped.
Error Count	The total number of errors.