From: bert hubert Date: Thu, 4 Oct 2018 08:20:10 +0000 (+0200) Subject: Clarify meaning of dnsdist statistics X-Git-Tag: dnsdist-1.3.3~66^2 X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=refs%2Fpull%2F7023%2Fhead;p=thirdparty%2Fpdns.git Clarify meaning of dnsdist statistics The various statistics kept by dnsdist do add up to a coherent picture, this PR documents how. --- diff --git a/pdns/dnsdistdist/docs/statistics.rst b/pdns/dnsdistdist/docs/statistics.rst index 7da54dcad9..7344afd7d6 100644 --- a/pdns/dnsdistdist/docs/statistics.rst +++ b/pdns/dnsdistdist/docs/statistics.rst @@ -10,9 +10,21 @@ dnsdist keeps statistics on the queries is receives and send out. They can be ac - via Carbon / Graphite / Metronome export (see :doc:`../guides/carbon`) - via SNMP (see :doc:`../advanced/snmp`) +To make sense of the statistics, the following relation should hold: + + queries - noncompliant-queries + = + responses - noncompliant-responses + cache-hits + downstream-timeouts + self-answered + no-policy + + rule-drop + +Note that packets dropped by eBPF (see :doc:`../advanced/ebpf`) are +accounted for in the eBPF statistics, and do not show up in the metrics +described on this page. + acl-drops --------- -The number of packets dropped because of the :doc:`ACL `. +The number of packets (or TCP messages) dropped because of the :doc:`ACL `. +If a packet or message is dropped, it is not counted in the `queries` statistic. cache-hits ---------- @@ -48,7 +60,8 @@ Number of queries dropped because of a dynamic block. empty-queries ------------- -Number of empty queries received from clients. +Number of empty queries received from clients. Every empty-query is also +counted as a `query`. fd-usage --------