From c69cb8cc094cc916adbc516b09e944cd3d137c01 Mon Sep 17 00:00:00 2001
From: Daniel Baumann <daniel.baumann@progress-linux.org>
Date: Sat, 27 Apr 2024 13:08:07 +0200
Subject: Adding upstream version 1.29.3.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
---
 collectors/python.d.plugin/dnsdist/README.md | 72 ++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 collectors/python.d.plugin/dnsdist/README.md

(limited to 'collectors/python.d.plugin/dnsdist/README.md')

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'
+```
+
+[![analytics](https://www.google-analytics.com/collect?v=1&aip=1&t=pageview&_s=1&ds=github&dr=https%3A%2F%2Fgithub.com%2Fnetdata%2Fnetdata&dl=https%3A%2F%2Fmy-netdata.io%2Fgithub%2Fcollectors%2Fpython.d.plugin%2Fdnsdist%2FREADME&_u=MAC~&cid=5792dfd7-8dc4-476b-af31-da2fdb9f93d2&tid=UA-64295674-3)](<>)
-- 
cgit v1.2.3