dns

Documentation

Overview

Package dns implements a DNS prober. It sends UDP DNS queries to a list of targets and reports statistics on queries sent, queries received, and latency experienced.

This prober uses the DNS library in /third_party/golang/dns/dns to construct, send, and receive DNS messages. Every message is sent on a different UDP port. Queries to each target are sent in parallel.

Index

• type Client
• type ClientImpl
  • func (c *ClientImpl) SetReadTimeout(d time.Duration)
• type Probe
  • func (p *Probe) Init(name string, opts *options.Options) error
  • func (p *Probe) Start(ctx context.Context, dataChan chan *metrics.EventMetrics)

Types

type Client

type Client interface {
	Exchange(*dns.Msg, string) (*dns.Msg, time.Duration, error)
	SetReadTimeout(time.Duration)
}

Client provides a DNS client interface for required functionality. This makes it possible to mock.

type ClientImpl

type ClientImpl struct {
	dns.Client
}

ClientImpl is a concrete DNS client that can be instantiated.

func (*ClientImpl) SetReadTimeout

func (c *ClientImpl) SetReadTimeout(d time.Duration)

SetReadTimeout allows write-access to the underlying ReadTimeout variable.

type Probe

type Probe struct {
	// contains filtered or unexported fields
}

Probe holds aggregate information about all probe runs, per-target.

func (*Probe) Init

func (p *Probe) Init(name string, opts *options.Options) error

Init initializes the probe with the given params.

func (*Probe) Start

func (p *Probe) Start(ctx context.Context, dataChan chan *metrics.EventMetrics)

Start starts and runs the probe indefinitely.