mirror of
https://github.com/coredns/coredns.git
synced 2025-11-12 23:12:17 -05:00
d8714e64e4
* Rename middleware to plugin first pass; mostly used 'sed', few spots where I manually changed text. This still builds a coredns binary. * fmt error * Rename AddMiddleware to AddPlugin * Readd AddMiddleware to remain backwards compat
62 lines
1.3 KiB
Markdown
62 lines
1.3 KiB
Markdown
# dnstap
|
|
|
|
*dnstap* enables logging to dnstap, a flexible, structured binary log format for DNS software: http://dnstap.info.
|
|
|
|
There is a buffer, expect at least 13 requests before the server sends its dnstap messages to the socket.
|
|
|
|
## Syntax
|
|
|
|
~~~ txt
|
|
dnstap SOCKET [full]
|
|
~~~
|
|
|
|
* **SOCKET** is the socket path supplied to the dnstap command line tool.
|
|
* `full` to include the wire-format DNS message.
|
|
|
|
## Examples
|
|
|
|
Log information about client requests and responses to */tmp/dnstap.sock*.
|
|
|
|
~~~ txt
|
|
dnstap /tmp/dnstap.sock
|
|
~~~
|
|
|
|
Log information including the wire-format DNS message about client requests and responses to */tmp/dnstap.sock*.
|
|
|
|
~~~ txt
|
|
dnstap unix:///tmp/dnstap.sock full
|
|
~~~
|
|
|
|
Log to a remote endpoint.
|
|
|
|
~~~ txt
|
|
dnstap tcp://127.0.0.1:6000 full
|
|
~~~
|
|
|
|
## Dnstap command line tool
|
|
|
|
~~~ sh
|
|
go get github.com/dnstap/golang-dnstap
|
|
cd $GOPATH/src/github.com/dnstap/golang-dnstap/dnstap
|
|
go build
|
|
./dnstap
|
|
~~~
|
|
|
|
The following command listens on the given socket and decodes messages to stdout.
|
|
|
|
~~~ sh
|
|
dnstap -u /tmp/dnstap.sock
|
|
~~~
|
|
|
|
The following command listens on the given socket and saves message payloads to a binary dnstap-format log file.
|
|
|
|
~~~ sh
|
|
dnstap -u /tmp/dnstap.sock -w /tmp/test.dnstap
|
|
~~~
|
|
|
|
Listen for dnstap messages on port 6000.
|
|
|
|
~~~ sh
|
|
dnstap -l 127.0.0.1:6000
|
|
~~~
|