Skip to content

About

Prometheus exporter for BIND

Resources

Code of conduct

Security policy

Stars

354 stars

Watchers

83 watching

Forks

Repository files navigation

Bind Exporter

GoDoc Build Status Go Report Card

Export BIND (named/dns) v9+ service metrics to Prometheus.

Getting started

Build and run from source

go get github.com/prometheus-community/bind_exporter
cd $GOPATH/src/github.com/prometheus-community/bind_exporter
make
./bind_exporter [flags]

Run in Docker container

  1. Pull Docker container using a specific version:
docker pull prometheuscommunity/bind-exporter:v0.3.0
  1. Run in a Docker container (as daemon), use --network host when communicating with named via localhost:
docker run -d --network host prometheuscommunity/bind-exporter:v0.3.0

Examples

Run bind_exporter in a Docker container and communicate with named on non-default statistics URL:

docker run -d prometheuscommunity/bind-exporter:v0.3.0 --bind.stats-url http://<IP/hostname>:8053

TLS and basic authentication

The Bind Exporter supports TLS and basic authentication.

To use TLS and/or basic authentication, you need to pass a configuration file using the --web.config.file parameter. The format of the file is described in the exporter-toolkit repository.

Other resources

Grafana Dashboard #12309

Troubleshooting

Make sure BIND was built with libxml2 support. You can check with the following command: named -V | grep libxml2.

Configure BIND to open a statistics channel. It's recommended to run the bind_exporter next to BIND, so it's only necessary to open a port locally.

statistics-channels {
  inet 127.0.0.1 port 8053 allow { 127.0.0.1; };
};

Copyright @ 2016 DigitalOcean™ Inc.

About

Prometheus exporter for BIND

Resources

Code of conduct

Security policy

Stars

354 stars

Watchers

83 watching

Forks

Releases

Packages

Used by

Contributors

Languages