MetricsHub
MetricsHub Community Connectors 1.0.22

 Supported Platforms[1]   Connectors Directory[2]

libvirt (virsh)

Description

This connector enables hardware monitoring for VMs through the virsh command. The libvirt API must be installed on the host.

community[3] hardware[4] linux[5]

Source[6]

Target

Typical platforms: Linux[7], Microsoft Windows[8], QEMU/KVM[9], VMware[10], VirtualBox[11], Xen[12]

Operating system: Linux

Prerequisites

Leverages: libvirt API

Technology and protocols: Commands

Examples

CLI

metricshub HOSTNAME -t linux -c +Virsh --ssh -u USER

metricshub.yaml

resourceGroups:
  <RESOURCE_GROUP>:
    resources:
      <HOSTNAME-ID>:
        attributes:
          host.name: <HOSTNAME> # Change with actual host name
          host.type: linux
        connectors: [ +Virsh ] # Optional, to load only this connector
        protocols:
          ssh:
            username: <USERNAME> # Change with actual credentials
            password: <PASSWORD> # Encrypted using metricshub-encrypt

Connector Activation Criteria

The libvirt (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
vm
  • hw.power_state{hw.type="vm", state="off|on|suspended"}
  • hw.vm.power_ratio
  • hw.parent.type
  • id
  • info
  • name
  • vm.host.name
metricshub community connector hardware system
Links:
  • [1] ../supported-platforms.html
  • [2] ../connectors-directory.html
  • [3] tags/community.html
  • [4] tags/hardware.html
  • [5] tags/linux.html
  • [6] https://github.com/metricshub/community-connectors/tree/main/src/main/connector/hardware/Virsh/Virsh.yaml
  • [7] platforms/linux.html
  • [8] platforms/microsoft-windows.html
  • [9] platforms/qemu-kvm.html
  • [10] platforms/vmware.html
  • [11] platforms/virtual-box.html
  • [12] platforms/xen.html
Searching...
No results.