Skip to content

Commit

Permalink
Point the user towards tcpdump for logging individual queries
Browse files Browse the repository at this point in the history
The lack of logging is explained, but appears to assume the user is
interested in aggregate log. For simple debugging there is no equivalent
to "log-queries" (or "log-replies") in unbound(8).

If the method described in [*] is the recommended one then it should be
documented as such and also saves time.

It's not clear to me what the difference between doc/*.rst and doc/README
is. This patch assumes README is already out of date.

[*] https://lists.nlnetlabs.nl/pipermail/nsd-users/2020-June/002880.html
  • Loading branch information
hills committed Aug 22, 2024
1 parent 8728e0f commit fc1e84d
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions doc/manual/running/logging.rst
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,11 @@ in order to keep NSD focused and minimise its complexity.
It is better to leave logging and tracing to separate dedicated tools. Do note,
however, that NSD can be compiled with support for DNSTAP (see ``nsd.conf(5)``).

If some visibility on individual queries is required, consider running
``tcpdump(1)`` on the server, using an appropriate filter rule to capture UDP
and TCP packets to port 53. The tcpdump on most systems will decode the packets
into readable requests and responses.

The `CAIDA dnsstat tool <https://www.caida.org/catalog/software/dnsstat/>`_ can
easily be configured and/or modified to suit local statistics requirements
without any danger of affecting the name server itself. We have run ``dnsstat``
Expand Down

0 comments on commit fc1e84d

Please sign in to comment.