BIND 9 DNS Server Metrics
For how the subagent reads BIND statistics and how to configure it, see BIND 9 DNS Server Monitoring.
These metrics are provided by the bind9 subagent.
It reads them from the JSON server statistics of the BIND 9 statistics channel (/json/v1/server); see BIND 9 DNS Server Monitoring.
The BIND field row of each metric is the path of the field in the JSON document.
Counters (nsstats/…, zonestats/…) are cumulative since named started.
BIND omits zero counters from nsstats and zonestats.
The built-in counter metrics return 0 when the counter or its entire section is missing from valid BIND statistics.
Server Information
Bind9.BootTime
Time when named started, as reported by BIND: UTC in ISO 8601 format, for example 2026-11-20T08:15:42.123Z (BIND 9.10 reports no milliseconds).
Data Type |
String |
Platforms |
All |
BIND field |
|
Bind9.ConfigTime
Time of the last configuration change in named: startup, configuration reload (for example rndc reload or rndc reconfig), or a zone added, changed, or deleted with rndc addzone, rndc modzone, or rndc delzone.
Same format as Bind9.BootTime.
Data Type |
String |
Platforms |
All |
BIND field |
|
Query Results
Bind9.Answers.Auth
Number of queries that resulted in an authoritative answer.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Answers.FORMERR
Number of queries that resulted in a FORMERR (format error) response.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Answers.NoData
Number of queries that resulted in a NOERROR response with no data: the name exists, but has no records of the requested type.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Answers.NonAuth
Number of queries that resulted in a non-authoritative answer.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Answers.NXDOMAIN
Number of queries that resulted in an NXDOMAIN response (the name does not exist).
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Answers.Recursive
Number of queries that caused the server to perform recursion to find the final answer.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Requests
Bind9.Requests.Completed.Updates
Number of completed dynamic updates.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Completed.ZoneTransfers
Number of zone transfers that were requested from this server and completed.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Failed.Dropped
Number of recursive queries that the server dropped because of configured limits, such as clients-per-query, max-clients-per-query, fetches-per-zone, fetches-per-server, and rate-limit.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Failed.Other
Number of query failures. BIND keeps this counter for compatibility; most failures it includes are also counted by more specific counters, such as rejected authoritative and recursive queries.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Received.IPv4
Number of requests received over IPv4. Includes requests that are not queries, such as NOTIFY and dynamic update requests.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Received.IPv6
Number of requests received over IPv6. Includes requests that are not queries, such as NOTIFY and dynamic update requests.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Received.TCP
Number of requests received over TCP.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Rejected.Authoritative
Number of rejected authoritative (non-recursive) queries.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Requests.Rejected.Recursive
Number of rejected recursive queries.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
NOTIFY Messages
Bind9.Notifies.Received.IPv4
Number of NOTIFY messages received over IPv4.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Bind9.Notifies.Received.IPv6
Number of NOTIFY messages received over IPv6.
Data Type |
Counter 64-bit |
Platforms |
All |
BIND field |
|
Other Fields
Bind9.Other(path)
Value of any field of the JSON server statistics, selected by its path.
Path elements are separated by /; a leading / is optional.
The field must hold an integer or a string. Integers are returned as decimal text.
If the field is missing or has another type, the metric returns Not supported.
Examples of paths in current BIND versions:
-
nsstats/QrySuccess— queries that resulted in a successful answer (NOERROR with at least one answer record) -
rcodes/NOERROR— responses sent, by response code -
qtypes/AAAA— queries received, by query type -
views/_default/resolver/stats/Queryv4— IPv4 queries sent by the resolver of the default view -
current-time— current time of the server
For the list of counters, see the statistics section of the BIND Administrator Reference Manual, or read the JSON document from the statistics channel.
Data Type |
String |
Platforms |
All |
| Argument | Type | Description |
|---|---|---|
path |
String |
Path of the field in the JSON document, up to 255 characters |