powerdns_exporter

README

PowerDNS Exporter

PowerDNS exporter for Prometheus

Periodically scrapes metrics via the PowerDNS HTTP-API and exports them via HTTP/JSON for consumption by Prometheus.

The following PowerDNS products are supported

• Authoritative Server
• Recursor
• Dnsdist (coming soon)

---

Flags

Name	Description	Default
listen-address	Host:Port pair to run exporter on	:9120
metric-path	Path under which to expose metrics for Prometheus	/metrics
api-url	Base-URL of PowerDNS authoritative server/recursor API	http://localhost:8081/api/v1/
api-key	PowerDNS API Key	-

The api-url flag value should be passed in this format:

• PowerDNS server/recursor 3.x: http://<HOST>:<API-PORT>/
• PowerDNS server/recursor 4.x: http://<HOST>:<API-PORT>/api/v1/

Building

git clone https://github.com/fuze/powerdns_exporter.git
cd powerdns_exporter
docker run -it -v $(pwd):/powerdns_exporter golang:1.12 /bin/bash
cd /powerdns_exporter
go get github.com/prometheus/client_golang/prometheus
go get github.com/sirupsen/logrus
go get gopkg.in/alecthomas/kingpin.v2
make build

A Makefile is provided in case you find a need for it.

Usage

See here for instructions on how to enable the HTTP API in PowerDNS.

Then run the exporter like this:

powerdns_exporter api-url="http://<HOST>:<API-PORT>/api/v1/" -api-key="<YOUR_API_KEY>"

Show help:

powerdns_exporter --help