search

hansmi / prometheus-lvm-exporter

Prometheus exporter for LVM metrics.
BSD 3-Clause "New" or "Revised" License
23 stars 5 forks source link
lvm lvm2 metrics monitoring prometheus-exporter

readme

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:

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.