Skip to content

prometheus-community/bind_exporter

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
November 10, 2022 20:22
September 18, 2021 13:24
April 27, 2022 15:15
November 10, 2022 20:22
November 10, 2022 20:22
April 27, 2022 14:44
January 8, 2020 09:51
December 2, 2019 14:10
November 10, 2022 20:22

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: https://grafana.com/dashboards/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.