https://github.com/fuze/powerdns_exporter

:chart_with_upwards_trend: Prometheus metrics exporter for PowerDNS
https://github.com/fuze/powerdns_exporter

Last synced: 5 days ago
JSON representation

:chart_with_upwards_trend: Prometheus metrics exporter for PowerDNS

• Host: GitHub
• URL: https://github.com/fuze/powerdns_exporter
• Owner: fuze
• License: apache-2.0
• Fork: true (Jimdo/powerdns_exporter)
• Created: 2019-05-08T23:03:58.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2021-12-06T20:36:05.000Z (almost 3 years ago)
• Last Synced: 2024-08-01T12:23:10.811Z (3 months ago)
• Language: Go
• Homepage:
• Size: 1.25 MB
• Stars: 3
• Watchers: 7
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - fuze/powerdns_exporter - :chart_with_upwards_trend: Prometheus metrics exporter for PowerDNS (others)

README

        
# PowerDNS Exporter

[![Travis](https://img.shields.io/travis/janeczku/powerdns_exporter.svg)](https://travis-ci.org/janeczku/powerdns_exporter)

[PowerDNS](https://www.powerdns.com/) exporter for [Prometheus](http://prometheus.io/)

Periodically scrapes metrics via the [PowerDNS HTTP-API](https://doc.powerdns.com/md/httpapi/README/) and exports them via HTTP/JSON for consumption by Prometheus.

#### The following PowerDNS products are supported

* [Authoritative Server](https://www.powerdns.com/auth.html)

* [Recursor](https://www.powerdns.com/recursor.html)

* [Dnsdist](http://dnsdist.org/) (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://:/`

* PowerDNS server/recursor 4.x: `http://:/api/v1/`

## Building

```bash

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](https://doc.powerdns.com/md/httpapi/README/) for instructions on how to enable the HTTP API in PowerDNS.

Then run the exporter like this:

```bash

powerdns_exporter -api-url="http://:/api/v1/" -api-key=""

```

Show help:

```bash

powerdns_exporter --help

```