dns

Documentation

Overview

Package dns is a generated protocol buffer package.

It is generated from these files:

github.com/google/cloudprober/probes/dns/config.proto

It has these top-level messages:

ProbeConf

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

• Constants
• type Client
• type ClientImpl
  • func (c *ClientImpl) SetReadTimeout(d time.Duration)
• type Probe
  • func (p *Probe) Init(name string, tgts targets.Targets, interval, timeout time.Duration, ...) error
  • func (p *Probe) Start(ctx context.Context, dataChan chan *metrics.EventMetrics)
• type ProbeConf
  • func (*ProbeConf) Descriptor() ([]byte, []int)
  • func (m *ProbeConf) GetResolvedDomain() string
  • func (m *ProbeConf) GetStatsExportIntervalMsec() int32
  • func (*ProbeConf) ProtoMessage()
  • func (m *ProbeConf) Reset()
  • func (m *ProbeConf) String() string

Constants

const Default_ProbeConf_ResolvedDomain string = "www.google.com."

const Default_ProbeConf_StatsExportIntervalMsec int32 = 10000

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, tgts targets.Targets, interval, timeout time.Duration, l *logger.Logger, v interface{}) 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.

type ProbeConf

type ProbeConf struct {
	// Domain to use when making DNS queries
	ResolvedDomain *string `protobuf:"bytes,1,opt,name=resolved_domain,json=resolvedDomain,def=www.google.com." json:"resolved_domain,omitempty"`
	// Export stats after these many milliseconds
	StatsExportIntervalMsec *int32 `` /* 138-byte string literal not displayed */
	XXX_unrecognized        []byte `json:"-"`
}

func (*ProbeConf) Descriptor

func (*ProbeConf) Descriptor() ([]byte, []int)

func (*ProbeConf) GetResolvedDomain

func (m *ProbeConf) GetResolvedDomain() string

func (*ProbeConf) GetStatsExportIntervalMsec

func (m *ProbeConf) GetStatsExportIntervalMsec() int32

func (*ProbeConf) ProtoMessage

func (*ProbeConf) ProtoMessage()

func (*ProbeConf) Reset

func (m *ProbeConf) Reset()

func (*ProbeConf) String

func (m *ProbeConf) String() string