Reference

show resolvers

Display statistics for each resolvers section in your configuration.

Description Jump to heading

A resolvers section lists one or more DNS nameservers, to which the load balancer sends DNS queries. The show resolvers command lists the following information for each resolvers section that you’ve defined in your load balancer configuration:

Field Displays the number of
sent DNS requests sent to this group of nameservers
snd_error Times there was an error sending the DNS query
valid Valid DNS responses received from this group of nameservers
update DNS responses used to update a server’s IP address
cname CNAME responses
cname_error CNAME errors returned from this group of nameservers
any_err "Empty responses (i.e.
nx Non-existent domain responses received from this group of nameservers
timeout Times this group of nameservers did not answer in time
refused Requests refused by this group of nameservers
other Any other DNS errors
invalid Invalid DNS responses (from a protocol point of view)
too_big Responses that were too big to process
truncated Responses that were truncated
outdated Responses that arrived too late (after another nameserver)

Without any arguments, show resolvers returns information about all resolvers sections. You can filter this to show only a specific section by adding its name.

Examples Jump to heading

Below, we display information about a resolvers section named example:

nix
echo "show resolvers example" | \
sudo socat stdio tcp4-connect:127.0.0.1:9999
nix
echo "show resolvers example" | \
sudo socat stdio tcp4-connect:127.0.0.1:9999
output
text
Resolvers section example
nameserver ns1:
sent: 16
snd_error: 0
valid: 2
update: 0
cname: 0
cname_error: 0
any_err: 2
nx: 0
timeout: 0
refused: 12
other: 0
invalid: 0
too_big: 0
truncated: 0
outdated: 0
output
text
Resolvers section example
nameserver ns1:
sent: 16
snd_error: 0
valid: 2
update: 0
cname: 0
cname_error: 0
any_err: 2
nx: 0
timeout: 0
refused: 12
other: 0
invalid: 0
too_big: 0
truncated: 0
outdated: 0

See also Jump to heading

Do you have any suggestions on how we can improve the content of this page?