Skip to content

jimmystewpot/pdns-statsd-proxy

Repository files navigation

PowerDNS statistics to statsd bridge

Build Status codecov Quality Gate StatusVulnerabilitiesTechnical DebtMaintainability Rating

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

FOSSA Status

About

A PowerDNS statistics API to statsd proxy/bridge

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published