KVM, QEMU, Xen and Hypervisors (virsh)

Home

Back to the list of connectors

Description

This connector provides VM monitoring through the virsh command. The host requires the libvirt API installed.

Connector ID: Virsh

Target

Typical platforms: KVM, QEMU, Xen, Hypervisors

Operating system: Linux

Prerequisites

Leverages: libvirt API

Technology and protocols: System Commands

Examples

CLI

hws HOSTNAME -t linux -f Virsh --ssh -u USER

hws-config.yaml

hosts:
- host:
    hostname: <HOSTNAME> # Change with actual host name
    type: linux
  selectedConnectors: [ Virsh ] # Optional, to load only this connector
  ssh:
    username: <USERNAME> # Change with actual credentials
    password: <PASSWORD> # Encrypted using hws-encrypt

Connector Activation Criteria

The KVM, QEMU, Xen and Hypervisors (virsh) connector will be automatically activated, and its status will be reported as OK if all the below criteria are met:

The command below succeeds on the monitored host
- Command: virsh list
- Output contains: Name (regex)

Metrics

Type	Collected Metrics	Specific Attributes (Labels)
Virtual Machine	`hw.energy{hw.type="vm"}` `hw.status{hw.type="vm",state="present"}` `hw.vm.power_state{state="on\|off\|suspended"}`	`info` `vm.host.name`

Search Results for {{siteSearch | truncate:'50'}}

No results.