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. In the nsstats and zonestats sections, BIND omits counters that are zero, so a metric for such a counter is not supported until the counter becomes non-zero. The subagent returns counters as 64-bit values, although the metrics are declared as Unsigned Integer.

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

boot-time

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

config-time

Bind9.Version

BIND version, for example 9.20.8. BIND reports this field from version 9.11; with BIND 9.10 the metric is not supported.

Data Type

String

Platforms

All

BIND field

version

Query Results

Bind9.Answers.Auth

Number of queries that resulted in an authoritative answer.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/QryAuthAns

Bind9.Answers.FORMERR

Number of queries that resulted in a FORMERR (format error) response.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/QryFORMERR

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

Unsigned Integer

Platforms

All

BIND field

nsstats/QryNxrrset

Bind9.Answers.NonAuth

Number of queries that resulted in a non-authoritative answer.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/QryNoauthAns

Bind9.Answers.NXDOMAIN

Number of queries that resulted in an NXDOMAIN response (the name does not exist).

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/QryNXDOMAIN

Bind9.Answers.Recursive

Number of queries that caused the server to perform recursion to find the final answer.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/QryRecursion

Bind9.Answers.Referral

Number of queries that resulted in a referral answer.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/QryReferral

Bind9.Answers.SERVFAIL

Number of queries that resulted in a SERVFAIL (server failure) response.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/QrySERVFAIL

Requests

Bind9.Requests.Completed.Updates

Number of completed dynamic updates.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/UpdateDone

Bind9.Requests.Completed.ZoneTransfers

Number of zone transfers that were requested from this server and completed.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/XfrReqDone

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

Unsigned Integer

Platforms

All

BIND field

nsstats/QryDropped

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

Unsigned Integer

Platforms

All

BIND field

nsstats/QryFailure

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

Unsigned Integer

Platforms

All

BIND field

nsstats/Requestv4

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

Unsigned Integer

Platforms

All

BIND field

nsstats/Requestv6

Bind9.Requests.Received.TCP

Number of requests received over TCP.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/ReqTCP

Bind9.Requests.Rejected.Authoritative

Number of rejected authoritative (non-recursive) queries.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/AuthQryRej

Bind9.Requests.Rejected.Recursive

Number of rejected recursive queries.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/RecQryRej

Bind9.Requests.Rejected.Updates

Number of rejected dynamic update requests.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/UpdateRej

Bind9.Requests.Rejected.ZoneTransfers

Number of rejected zone transfer requests.

Data Type

Unsigned Integer

Platforms

All

BIND field

nsstats/XfrRej

NOTIFY Messages

Bind9.Notifies.Received.IPv4

Number of NOTIFY messages received over IPv4.

Data Type

Unsigned Integer

Platforms

All

BIND field

zonestats/NotifyInv4

Bind9.Notifies.Received.IPv6

Number of NOTIFY messages received over IPv6.

Data Type

Unsigned Integer

Platforms

All

BIND field

zonestats/NotifyInv6

Bind9.Notifies.Sent.IPv4

Number of NOTIFY messages sent over IPv4.

Data Type

Unsigned Integer

Platforms

All

BIND field

zonestats/NotifyOutv4

Bind9.Notifies.Sent.IPv6

Number of NOTIFY messages sent over IPv6.

Data Type

Unsigned Integer

Platforms

All

BIND field

zonestats/NotifyOutv6

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; the metric is not supported for objects, arrays, and fields that BIND does not report.

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

Unsigned Integer (string fields are returned as strings)

Platforms

All

Table 1. Arguments
Argument Type Description

path

String

Path of the field in the JSON document, up to 255 characters