This article will help you get the Dns plugin for sd-agent configured and returning metrics
Installing the dns plugin package
Install the dns plugin on Debian/Ubuntu:
sudo apt-get install sd-agent-dns-check
Install the dns plugin on RHEL/CentOS:
sudo yum install sd-agent-dns-check
Read more about agent plugins.
Configuring the agent to monitor DNS
1. Configure /etc/sd-agent/conf.d/dns_check.yaml
init_config: instances: - name: Server Density (com) # nameserver: 22.214.171.124 # The nameserver to query, this must be an IP address hostname: serverdensity.com # the record to fetch # record_type: AAAA # default is A - name: Example (org) hostname: example.org
If you do not provide a nameserver the check will use the nameserver configured in the local network settings.
2. Restart the agent
sudo /etc/init.d/sd-agent restart
sudo systemctl restart sd-agent
Verifying the configuration
Execute info to verify the configuration with the following:
sudo /etc/init.d/sd-agent info
If the agent has been configured correctly you'll see an output such as:
dns ----- - instance #0 [OK] - Collected * metrics
You can also view the metrics returned with the following command:
sudo -u sd-agent /usr/share/python/sd-agent/agent.py check dns_check
Click the name of your server from the Devices list in your Server Density account then go to the Metrics tab. Click the + Graph button on the right then choose the dns metrics to display the graphs. The metrics will also be available to select when building dashboard graphs.
The response time for DNS query for a given record, tagged by hostname, e.g. 'hostname:example.com'.
| second / None |