Mirrors/coredns
1
0
Fork 0
mirror of https://github.com/coredns/coredns.git synced 2025-11-06 12:06:37 -05:00
Code Issues Packages Projects Releases Wiki Activity

resolve #789 (#791)

Browse Source
This commit is contained in:
varyoo
2017-07-25 22:14:01 +02:00
committed by Miek Gieben
parent cf92a66573
commit 82954c1c29
1 changed files with 36 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files

43
middleware/dnstap/README.md
View File

@@ -1,20 +1,49 @@
# 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
`dnstap SOCKET [full]`
~~~ txt
dnstap SOCKET [full]
~~~
* **SOCKET** is the socket path supplied to the dnstap command line tool.
* `full` to include the wire-format dns message.
* `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 /tmp/dnstap.sock full
~~~
## Dnstap command line tool
```sh
~~~ sh
go get github.com/dnstap/golang-dnstap
cd $GOPATH/src/github.com/dnstap/golang-dnstap/dnstap
go build
./dnstap -u /tmp/dnstap.sock
./dnstap -u /tmp/dnstap.sock -y
```
./dnstap
~~~
There is a buffer, expect at least 13 requests before the server sends its dnstap messages to the socket.
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
~~~