telegraf/plugins/inputs/dns_query
Daniel Nelson 840d19db35 Add network option to dns_query (#3042) 2017-07-21 16:56:08 -07:00
..
README.md Add network option to dns_query (#3042) 2017-07-21 16:56:08 -07:00
dns_query.go Add network option to dns_query (#3042) 2017-07-21 16:56:08 -07:00
dns_query_test.go use AddError everywhere (#2372) 2017-04-24 11:13:26 -07:00

README.md

DNS Query Input Plugin

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

Configuration:

# Sample Config:
[[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

For querying more than one record type make:

[[inputs.dns_query]]
  domains = ["mjasion.pl"]
  servers = ["8.8.8.8", "8.8.4.4"]
  record_type = "A"

[[inputs.dns_query]]
  domains = ["mjasion.pl"]
  servers = ["8.8.8.8", "8.8.4.4"]
  record_type = "MX"

Tags:

  • server
  • domain
  • record_type

Example output:

telegraf --input-filter dns_query --test
> dns_query,domain=mjasion.pl,record_type=A,server=8.8.8.8 query_time_ms=67.189842 1456082743585760680