https://github.com/prometheus-community/bind_exporter
Prometheus exporter for BIND
https://github.com/prometheus-community/bind_exporter
Last synced: 6 days ago
JSON representation
Prometheus exporter for BIND
- Host: GitHub
- URL: https://github.com/prometheus-community/bind_exporter
- Owner: prometheus-community
- License: apache-2.0
- Created: 2015-08-27T15:03:59.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-02-01T10:20:39.000Z (20 days ago)
- Last Synced: 2025-02-08T10:01:39.372Z (13 days ago)
- Language: Go
- Homepage:
- Size: 3.13 MB
- Stars: 309
- Watchers: 88
- Forks: 104
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
# Bind Exporter
[](https://godoc.org/github.com/prometheus-community/bind_exporter)
[](https://circleci.com/gh/prometheus-community/bind_exporter)
[](https://goreportcard.com/report/prometheus-community/bind_exporter)
Export BIND (named/dns) v9+ service metrics to Prometheus.
## Getting started
### Build and run from source
```bash
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:
```bash
docker pull prometheuscommunity/bind-exporter:v0.3.0
```
2. Run in a Docker container (as daemon), use `--network host` when communicating with `named` via `localhost`:
```bash
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:
```bash
docker run -d prometheuscommunity/bind-exporter:v0.3.0 --bind.stats-url http://: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](https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md).
## Other resources
[Grafana Dashboard #12309](https://grafana.com/grafana/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.