diff options
Diffstat (limited to '')
| -rw-r--r-- | collectors/python.d.plugin/dnsdist/README.md | 72 |
1 files changed, 72 insertions, 0 deletions
diff --git a/collectors/python.d.plugin/dnsdist/README.md b/collectors/python.d.plugin/dnsdist/README.md new file mode 100644 index 0000000..7c279ef --- /dev/null +++ b/collectors/python.d.plugin/dnsdist/README.md @@ -0,0 +1,72 @@ +<!-- +title: "PowerDNS dnsdist monitoring with Netdata" +custom_edit_url: https://github.com/netdata/netdata/edit/master/collectors/python.d.plugin/dnsdist/README.md +sidebar_label: "PowerDNS dnsdist" +--> + +# PowerDNS dnsdist monitoring with Netdata + +Collects load-balancer performance and health metrics, and draws the following charts: + +1. **Response latency** + + - latency-slow + - latency100-1000 + - latency50-100 + - latency10-50 + - latency1-10 + - latency0-1 + +2. **Cache performance** + + - cache-hits + - cache-misses + +3. **ACL events** + + - acl-drops + - rule-drop + - rule-nxdomain + - rule-refused + +4. **Noncompliant data** + + - empty-queries + - no-policy + - noncompliant-queries + - noncompliant-responses + +5. **Queries** + + - queries + - rdqueries + - rdqueries + +6. **Health** + + - downstream-send-errors + - downstream-timeouts + - servfail-responses + - trunc-failures + +## Configuration + +Edit the `python.d/dnsdist.conf` configuration file using `edit-config` from the Netdata [config +directory](/docs/configure/nodes.md), which is typically at `/etc/netdata`. + +```bash +cd /etc/netdata # Replace this path with your Netdata config directory, if different +sudo ./edit-config python.d/dnsdist.conf +``` + +```yaml +localhost: + name : 'local' + url : 'http://127.0.0.1:5053/jsonstat?command=stats' + user : 'username' + pass : 'password' + header: + X-API-Key: 'dnsdist-api-key' +``` + +[](<>) |