monitorstack/doc/source/plugins-base/plugin-kvm.rst

kvm - get details from running KVM instances

The KVM plugin connects to libvirt and retrieves details about KVM instances on the system. It returns basic information, including:

• number of instances on the host (kvm_vms)
• total number of virtual CPUs that libvirt can use (kvm_total_vcpus)
• the total number of virtual CPUs scheduled (kvm_scheduled_vcpus)

Usage

This plugin takes no arguments.

Example

Run the plugin:

$ monitorstack kvm

Example output in JSON format:

{
  "variables": {
    "kvm_vms": 1,
    "kvm_scheduled_vcpus": 2,
    "kvm_total_vcpus": 4
  },
  "meta": {
    "kvm_host_id": 2046744907101423228
  },
  "message": "kvm is ok",
  "exit_code": 0,
  "measurement_name": "kvm"
}