dnstap

README

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]

• 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.

dnstap /tmp/dnstap.sock

Log information including the wire-format DNS message about client requests and responses to /tmp/dnstap.sock.

dnstap /tmp/dnstap.sock full

Dnstap command line tool

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.

dnstap -u /tmp/dnstap.sock

The following command listens on the given socket and saves message payloads to a binary dnstap-format log file.

dnstap -u /tmp/dnstap.sock -w /tmp/test.dnstap

Documentation

Index

• type Dnstap
  • func (h Dnstap) Name() string
  • func (h Dnstap) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)
  • func (h Dnstap) TapMessage(m *tap.Message) error

Types

type Dnstap

type Dnstap struct {
	Next middleware.Handler
	Out  io.Writer
	Pack bool
}

func (Dnstap) Name

func (h Dnstap) Name() string

func (Dnstap) ServeDNS

func (h Dnstap) ServeDNS(ctx context.Context, w dns.ResponseWriter, r *dns.Msg) (int, error)

func (Dnstap) TapMessage

func (h Dnstap) TapMessage(m *tap.Message) error