A collection of Prometheus Exporters for Linux written in efficient C++.
You need:
- a C++20 compiler (e.g. GCC or clang)
- meson 0.56
- libfmt
- systemd
- yaml-cpp
- zlib
Optional dependencies:
Get the source code:
git clone --recursive https://github.com/CM4all/Prometheus-Exporters
Run meson:
meson setup output
Compile and install:
ninja -C output ninja -C output install
The exporters are designed to be run with systemd socket activation;
after installing the software, you have to install the systemd units
from the debian/ directory manually and start the socket units.
Some exporters need a configuration file in
/etc/cm4all/prometheus-exporters/ which you may need to copy from
debian/, too. All of this is automated with our Debian package,
and that is how we use them; we never install manually as described
here.
To build the Debian package, install the build dependencies
(dpkg-checkbuilddeps) and run:
dpkg-buildpackage -rfakeroot -b -uc -us
There is an APT repository with pre-built packages for Debian Bookworm
(amd64 and arm64); add to /etc/apt/sources.list:
deb [trusted=yes] https://deb.cm4all.net/debian/ bookworm-default main
(Unfortunately, it is not yet signed, therefore the trusted=yes
option is needed currently.)
By default, all socket units are bound to
/run/cm4all/prometheus-exporters/*.socket. For example, to test
the kernel exporter, run:
curl --unix-socket /run/cm4all/prometheus-exporters/kernel.socket http://localhost/