kvm.system_info

Retrieve KVM system information for the node, including the libvirt and QEMU versions, the number of virtual machines and how many are running, and from RVC 3.13.0, the capabilities the host offers to virtual machines.

JSON-RPC Request

{"jsonrpc":"2.0","id":1,"method":"kvm.system_info"}

JSON-RPC Response

{
    "jsonrpc": "2.0",
    "id": 1,
    "result": {
        "libvirt": "<libvirt_version>",
        "hypervisor": "<hypervisor_version>",
        "virtual_machines": {
            "cluster_managed": {
                "running": "<count>",
                "total": "<count>"
            },
            "non_cluster_managed": {
                "running": "<count>",
                "total": "<count>"
            },
            "running": "<count>",
            "total": "<count>"
        },
        "capabilities": {
            "arch": "<arch>",
            "vm_type": "<vm_type>",
            "emulator": "<emulator_path>",
            "machine": "<machine_type>",
            "max_vcpus": "<count>",
            "cpu_model": "<cpu_model>",
            "cpu_modes": ["<cpu_mode>"],
            "firmware": ["<firmware>"],
            "disk_buses": ["<disk_bus>"],
            "video_models": ["<video_model>"]
        }
    }
}

Response parameters

Parameter	Type	Description
`libvirt`	String	The libvirt version on the node.
`hypervisor`	String	The hypervisor and its version.
`virtual_machines`	Object	The number of running and total virtual machines, for cluster-managed VMs, non-cluster-managed VMs, and all VMs.
`capabilities.arch`	String	The host architecture.
`capabilities.vm_type`	String	The virtualization type. `kvm` when virtual machines are hardware accelerated.
`capabilities.emulator`	String	The path to the QEMU emulator.
`capabilities.machine`	String	The default machine type.
`capabilities.max_vcpus`	Integer	The maximum number of vCPUs per virtual machine.
`capabilities.cpu_model`	String	The CPU model given to a virtual machine that uses the `host-model` CPU mode.
`capabilities.cpu_modes`	Array	The supported CPU modes.
`capabilities.firmware`	Array	The available firmware types.
`capabilities.disk_buses`	Array	The available disk buses.
`capabilities.video_models`	Array	The available video models.

RVC CLI Example

rvc kvm system-info

Response

QEMU 10.0.2 hypervisor
libvirt 11.3.0

 Virtual Machines     Running  Total
------------------------------------
 Cluster Managed            2      2
 Non Cluster Managed        0      0
 All                        2      2

Host
  Architecture  x86_64
  VM Type       kvm
  Emulator      /usr/bin/qemu-system-x86_64
  Machine       pc-i440fx-10.0
  Max vCPUs     255
  CPU Model     Snowridge
  CPU Modes     host-passthrough, maximum, host-model, custom
  Firmware      efi
  Disk Buses    ide, fdc, scsi, virtio, usb, sata
  Video Models  vga, cirrus, vmvga, qxl, virtio, none, bochs, ramfb