dnsmasq_exporter/README.md
Brandon Richardson e3caa1dcf7
feat: add option to enable granular lease metrics (#24)
Introduce a new flag that can be used to expose each DHCP lease as a
specific metric. Given the high cardinality of these metrics, exposition
of lease information is disabled by default.

This feature takes cues from node_exporter collectors which are
disabled by default, like the `processes` or `systemd` collectors for
instance. Typically, high-cardinality metrics are against prometheus
best-practices but for smaller networks (like home networks) these
features can be quite powerful.
2023-04-07 18:09:17 +02:00

1.2 KiB

dnsmasq exporter

Build Status

dnsmasq_exporter is an exporter for Prometheus, allowing you to monitor/alert on the number of DHCP leases and various DNS statistics.

The minimum required version of dnsmasq is 2.69, which added support for querying the statistics via DNS.

See also the “cache statistics” section in https://manpages.debian.org/stretch/dnsmasq-base/dnsmasq.8.en.html#NOTES

This is not an official Google product.

Installation

go get -u github.com/google/dnsmasq_exporter

Usage

Place dnsmasq_exporter.service in /etc/systemd/system/dnsmasq_exporter.service, then enable and start the service using:

systemctl daemon-reload
systemctl enable --now dnsmasq_exporter

Alternative usage

docker build -t dnsmasq_exporter .
docker run --restart=unless-stopped --net=host dnsmasq_exporter

Then, add the endpoint to your Prometheus configuration file:

scrape_configs:
  - job_name: dnsmasq
    static_configs:
      - targets: ['localhost:9153']