Skip to content
Bleemeo Bleemeo

BIND

Auto-Detection
Exporter Metrics

Bleemeo monitors the BIND DNS server through automatic service detection and optional detailed metrics collection via a Prometheus exporter.

Auto-Detection

Section titled “Auto-Detection”

Glouton automatically detects BIND instances running on the host. If the auto-detected parameters are incorrect, you can override them manually by adding the following to /etc/glouton/conf.d/99-bind.conf:

service:
  # For a BIND running outside a container
  - type: "bind"
    address: "127.0.0.1"
    port: 53


  # For an additional BIND running outside a container
  - type: "bind"
    instance: "NAME_ASSOCIATED_WITH_YOUR_ADDITIONAL_SERVICE"
    address: "127.0.0.1"
    port: 54


  # For a BIND running in a Docker container
  - type: "bind"
    instance: "CONTAINER_NAME"
    address: "172.17.0.2"
    port: 53
Metric Description
service_status Status of BIND

Exporter Metrics

Section titled “Exporter Metrics”

Detailed BIND metrics are collected using the third-party bind_exporter.

Prerequisites

Section titled “Prerequisites”
  • BIND DNS server installed and running
  • Glouton agent installed on the same host
  • Go toolchain (if building from source) or access to GitHub releases

Service Configuration

Section titled “Service Configuration”

Enable the statistics channel in your BIND configuration (/etc/bind/named.conf or /etc/named.conf):

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

Restart BIND to apply the change:

Terminal window
sudo systemctl restart named

Verify the statistics channel is accessible:

Terminal window
curl http://localhost:8053/

Installing the Exporter

Section titled “Installing the Exporter”

Download the latest release from the bind_exporter releases page, or install with Go:

Terminal window
go install github.com/prometheus-community/bind_exporter@latest

Start the exporter:

Terminal window
bind_exporter --bind.stats-url="http://localhost:8053/"

The exporter listens on port 9119 by default. Verify it is working:

Terminal window
curl http://localhost:9119/metrics

For production use, create a systemd service unit to manage the exporter process.

Glouton Configuration

Section titled “Glouton Configuration”
Terminal window
sudo tee /etc/glouton/conf.d/99-bind.conf > /dev/null << 'EOF'
metric:
  prometheus:
    targets:
      - url: "http://localhost:9119/metrics"
        name: "bind"
        allow_metrics:
          - "bind_query_recursions_total"
          - "bind_responses_total"
          - "bind_up"
          - "bind_resolver_cache_rrsets"
EOF
Metric Description
bind_up Whether the BIND statistics channel is reachable (1 = up)
bind_query_recursions_total Total number of recursive queries performed
bind_responses_total Total number of DNS responses sent
bind_resolver_cache_rrsets Number of resource record sets currently in the resolver cache