https://github.com/janeczku/powerdns_exporter

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

metrics powerdns prometheus

Last synced: about 1 hour ago
JSON representation

:chart_with_upwards_trend: Prometheus metrics exporter for PowerDNS

• Host: GitHub
• URL: https://github.com/janeczku/powerdns_exporter
• Owner: janeczku
• License: apache-2.0
• Created: 2016-01-10T03:55:27.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2019-08-25T06:37:56.000Z (about 5 years ago)
• Last Synced: 2024-08-01T12:23:10.617Z (3 months ago)
• Topics: metrics, powerdns, prometheus
• Language: Go
• Homepage:
• Size: 37.1 KB
• Stars: 37
• Watchers: 4
• Forks: 35
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - janeczku/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:8001/`

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`

## Installation

Typical way of installing in Go should work.

```

go install

```

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

go run powerdns_exporter api-url="http://:/" -api-key=""

```

Show help:

```bash

go run powerdns_exporter --help

```

## Docker

To run the PowerDNS exporter as a Docker container, run:

    $ docker run -p 9120:9120 janeczku/powerdns-exporter -api-url="http://:/" -api-key=""