---
name: "pmdabind2"
section: "1"
platform: "linux"
package: "pcp-pmda-bind2"
version: "7.2.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/pmdabind2"
---

# pmdabind2(1)

BIND performance metrics domain agent (PMDA)

## NAME

**pmdabind2** - BIND performance metrics domain agent (PMDA)

## DESCRIPTION

This PMDA extracts performance data from BIND (Berkeley Internet Name Domain). It enables collection of most of the statistics metrics from the Bind server version 9 or later, which includes:

- •

  overall memory statistics

- •

  overall per-query statistics (general queries, EDNS/truncated responses, Update/Notify/AXFR/IXFR messages)

- •

  overall error statistics (Rejected, SERVFAIL, Update/XFR failures ...)

- •

  overall statistics per transport protocol, EDNS and per version of IP protocol

- •

  resolver statistics (successes, errors, round-trip times in several ranges)

- •

  detailed per-socket statistics with respect to the transport protocol and IP version including errors

- •

  detailed per-file-descriptor statistics including errors

The PMDA performs per-second collection of the whole data set (148 metrics on the test environment) with modest requirements (2% CPU usage on Intel i7-4700MQ @2.4 GHz, cca 30 MB RAM).

If more than 1 requests/sec is performed, the memoized values are used so that the statistics interface of the Bind server does not get overloaded.

## INSTALLATION

Configure BIND to export XML statistics via its REST interface. This requires BIND configuration to enable statistics exporting locally (at least).

```
statistics-channels {
    inet 127.0.0.1 port 8080 allow { 127.0.0.1; };
}
options { zone-statistics yes; }
# ./Install
```

The hostname (localhost), port (8080 above) and other configuration information must be specified in both the BIND configuration file as well as the `$PCP_PMDAS_DIR`/bind2/bind2.conf file.

```
# cd $PCP_PMDAS_DIR/bind2
# [ edit bind2.conf ]
  host=localhost.localdomain:8080
```

Once this is setup, you can access the names and values for the bind2 performance metrics by doing the following as root:

```
# cd $PCP_PMDAS_DIR/bind2
# ./Install
```

To uninstall, the following must be done as root:

```
# cd $PCP_PMDAS_DIR/bind2
# ./Remove
```

**pmdabind2** is launched by [*pmcd*(1)](/pmcd/1.md) and should never be executed directly. The Install and Remove scripts notify [*pmcd*(1)](/pmcd/1.md) when the agent is installed or removed.

## FILES

- **$PCP\_PMDAS\_DIR/bind2/bind2.conf**

  mandatory configuration file listing monitored bind2 instances

- **$PCP\_PMDAS\_DIR/bind2/Install**

  installation script for the **pmdabind2** agent

- **$PCP\_PMDAS\_DIR/bind2/Remove**

  undo installation script for the **pmdabind2** agent

- **$PCP\_LOG\_DIR/pmcd/bind2.log**

  default log file for error messages from **pmdabind2**

## PCP ENVIRONMENT

Environment variables with the prefix **PCP\_** are used to parameterize the file and directory names used by **PCP**. On each installation, the file **/etc/pcp.conf** contains the local values for these variables. The **$PCP\_CONF** variable may be used to specify an alternative configuration file, as described in [*pcp.conf*(5)](/pcp.conf/5.md).

## SEE ALSO

[**PCPIntro**(1)](/PCPIntro/1.md), [**pmcd**(1)](/pmcd/1.md), [**pmdanamed**(1)](/pmdanamed/1.md), [**named.conf**(5)](/named.conf/5.md) and [**named**(8)](/named/8.md).