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:

bash
echo "show resolvers example" | \
sudo socat stdio tcp4-connect:127.0.0.1:9999
bash
echo "show resolvers example" | \
sudo socat stdio tcp4-connect:127.0.0.1:9999
output
bash
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
bash
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

If this page was useful, please, Leave the feedback.

© 2023 HAProxy Technologies, LLC. All Rights Reserved
Manage Cookie Preferences