DNS query collector
This module provides DNS query round-trip time (RTT).
Metrics
All metrics have "dns_query." prefix.
Labels per scope:
- server: server, network, record_type.
| Metric |
Scope |
Dimensions |
Units |
| query_time |
server |
query_time |
seconds |
| query_status |
server |
success, network_error, dns_error |
status |
Configuration
Edit the go.d/dns_query.conf configuration file using edit-config from the
Netdata config directory, which is typically at /etc/netdata.
cd /etc/netdata # Replace this path with your Netdata config directory
sudo ./edit-config go.d/dns_query.conf
Here is an example:
jobs:
- name: job1
record_types:
- A
- AAAA
domains:
- google.com
- github.com
- reddit.com
servers:
- 8.8.8.8
- 8.8.4.4
For all available options please see
module configuration file.
Troubleshooting
To troubleshoot issues with the dns_query collector, run the go.d.plugin with the debug option enabled. The output
should give you clues as to why the collector isn't working.
-
Navigate to the plugins.d directory, usually at /usr/libexec/netdata/plugins.d/. If that's not the case on
your system, open netdata.conf and look for the plugins setting under [directories].
cd /usr/libexec/netdata/plugins.d/
-
Switch to the netdata user.
sudo -u netdata -s
-
Run the go.d.plugin to debug the collector:
./go.d.plugin -d -m dns_query