Skip to content

hansmi/prometheus-lvm-exporter

Repository files navigation

LVM metrics for Prometheus

Latest release Release workflow CI workflow Go reference

Prometheus exporter for the Logical Volume Manager (LVM, Wikipedia). It is only compatible with Linux and has been tested with LVM 2.03. All fields related to physical volumes, volume groups and logical volumes are reported, either as a standalone metric for numeric values or as a label on a per-entity info metric.

Usage

prometheus-lvm-exporter listens on TCP port 9845 by default. To listen on another address use the -web.listen-address flag (e.g. -web.listen-address=127.0.0.1:3000).

TLS and HTTP basic authentication is supported through the Prometheus exporter toolkit. A configuration file can be passed to the -web.config flag (documentation).

See the --help output for more flags.

Installation

Pre-built binaries are provided for all releases:

  • Binary archives (.tar.gz)
  • Debian/Ubuntu (.deb)
  • RHEL/Fedora (.rpm)

With the source being available it's also possible to produce custom builds directly using Go or GoReleaser.

Example metrics

lvm_pv_info{pv_fmt="lvm2",pv_name="/dev/sda1",pv_uuid="yc1zVe-…"} 1
lvm_pv_info{pv_fmt="lvm2",pv_name="/dev/sdb1",pv_uuid="WVIH97-…"} 1

lvm_pv_free_bytes{pv_uuid="WVIH97-…"} 9.14358272e+08
lvm_pv_free_bytes{pv_uuid="yc1zVe-…"} 1.040187392e+09

lvm_lv_size_bytes{lv_uuid="BUfEXc-…"} 1.30023424e+08
lvm_lv_size_bytes{lv_uuid="ijb7Yx-…"} 4.194304e+06

More examples can be found in the testdata files.