Libvirt exporter

Prometheus exporter for vm metrics written in Go with pluggable metric collectors.

Installation and Usage

If you are new to Prometheus and libvirt_exporter there is a simple step-by-step guide.

The libvirt_exporter listens on HTTP port 9108 by default. See the --help output for more options.

Docker

For situations where Docker deployment is needed, some extra flags must be used to allow the libvirt_exporter access to the host libvirt-sock file.

docker build -t prom/prometheus_libvirt_exporter:v2.0.1 .

docker run -d \
  --restart="always" \
  --net="host" \
  --name libvirt_exporter \
  -v "/var/run/libvirt/libvirt-sock:/var/run/libvirt/libvirt-sock" \
  prom/prometheus-libvirt-exporter:2.0.1

For Docker compose, similar flag changes are needed.

---
version: '3.8'

services:
  node_exporter:
    image: prom/prometheus-libvirt-exporter:2.0.1
    container_name: libvirt_exporter
    network_mode: host
    restart: always
    volumes:
      - '/var/run/libvirt/libvirt-sock:/var/run/libvirt/libvirt-sock'

Collectors

The tablesbelow list all existing collectors.

Extend collectors

Filtering enabled collectors

The libvirt_exporter will expose all metrics from enabled collectors by default. This is the recommended way to collect metrics to avoid errors when comparing metrics of different families.

For advanced use the node_exporter can be passed an optional list of collectors to filter metrics. The collect[] parameter may be used multiple times. In Prometheus configuration you can use this syntax under the scrape config.

  params:
    collect[]:
      - foo
      - bar

This can be useful for having different Prometheus servers collect specific metrics from nodes.

Development building and running

Prerequisites:

• Go compiler
• RHEL/CentOS: glibc-static package.

Building:

    git clone https://github.com/Jasper-zz/prometheus_libvirt_exporter.git
    cd prometheus_libvirt_exporter
    make build
    ./.build/prometheus_libvirt_exporter <flags>

To see all available configuration flags:

    ./.build/prometheus_libvirt_exporter -h