dns_query

package
v1.0.0-...-47f3d97 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 30, 2019 License: MIT Imports: 9 Imported by: 0

README

DNS Query Input Plugin

The DNS plugin gathers dns query times in miliseconds - like Dig

Configuration:
# Query given DNS server and gives statistics
[[inputs.dns_query]]
  ## servers to query
  servers = ["8.8.8.8"]

  ## Network is the network protocol name.
  # network = "udp"

  ## Domains or subdomains to query.
  # domains = ["."]

  ## Query record type.
  ## Posible values: A, AAAA, CNAME, MX, NS, PTR, TXT, SOA, SPF, SRV.
  # record_type = "A"

  ## Dns server port.
  # port = 53

  ## Query timeout in seconds.
  # timeout = 2
Metrics:
  • dns_query
    • tags:
      • server
      • domain
      • record_type
      • result
    • fields:
      • query_time_ms (float)
      • result_code (int, success = 0, timeout = 1, error = 2)
Example Output:
dns_query,domain=mjasion.pl,record_type=A,server=8.8.8.8 query_time_ms=67.189842 1456082743585760680

Documentation

Index

Constants

View Source
const (
	Success ResultType = 0
	Timeout            = 1
	Error              = 2
)

Variables

This section is empty.

Functions

This section is empty.

Types

type DnsQuery

type DnsQuery struct {
	// Domains or subdomains to query
	Domains []string

	// Network protocol name
	Network string

	// Server to query
	Servers []string

	// Record type
	RecordType string `toml:"record_type"`

	// DNS server port number
	Port int

	// Dns query timeout in seconds. 0 means no timeout
	Timeout int
}

func (*DnsQuery) Description

func (d *DnsQuery) Description() string

func (*DnsQuery) Gather

func (d *DnsQuery) Gather(acc telegraf.Accumulator) error

func (*DnsQuery) SampleConfig

func (d *DnsQuery) SampleConfig() string

type ResultType

type ResultType uint64

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL