jimmystewpot / pdns-statsd-proxy

A PowerDNS statistics API to statsd proxy/bridge

PowerDNS statistics to statsd bridge

Background: PowerDNS is a powerful open source DNS server that offers both recursive and authoritative packages. It has powerful statistics available via a HTTP RESTFul API, carbon protocol or via a cli tool. The problem with this is that not all metrics systems provide support for carbon or have http agents that support the PowerDNS API.

This tool aims to provide a lightweight http to statsd bridge/proxy. It will query the PowerDNS API and emit the metrics in either statsd gauge or increments to a statsd server of your choice.

PowerDNS Support

recursor

• 4.0
• 4.1
• 4.2
• 4.3

authoritative

• 4.3

Build

Requires Docker to be installed as it builds within a container to output binaries in Linux elf format.

make build

Will output an artifact to $PWD/bin

Install

make install

Will install the artifact from $PWD/bin into /opt/pdns-stats-proxy/ and the systemd unit (service)

Running

Enable in systemctl

systemctl enable pdns-stats-proxy

Architecture

This tool uses a worker model, a powerdns client will execute and poll, the statistics are then passed via channel to a statistics worker which then emits them via statsd.

License

pdns-statsd-proxy's Issues

Non-graceful failure when PowerDNS API stats are different

On our PowerDNS the statistics from the API are a slightly different - and as a results only 2 of the statistics are actually sent.
Probably when there's a missing statistic in the json result - the loop stops.
We've patched by setting in stats.go exactly the statistics that our server is providing - but there should be a better handling of this issue.