2016-02-15 15:10:04 +00:00
|
|
|
# DNS Query Input Plugin
|
2016-02-13 18:00:42 +00:00
|
|
|
|
|
|
|
|
The DNS plugin gathers dns query times in miliseconds - like [Dig](https://en.wikipedia.org/wiki/Dig_\(command\))
|
|
|
|
|
|
|
|
|
|
### Configuration:
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
# Sample Config:
|
2016-02-15 15:10:04 +00:00
|
|
|
[[inputs.dns_query]]
|
2016-02-13 18:00:42 +00:00
|
|
|
### Domains or subdomains to query
|
|
|
|
|
domains = ["mjasion.pl"] # required
|
|
|
|
|
|
|
|
|
|
### servers to query
|
|
|
|
|
servers = ["8.8.8.8"] # required
|
|
|
|
|
|
|
|
|
|
### Query record type. Posible values: A, CNAME, MX, TXT, NS. Default is "A"
|
|
|
|
|
recordType = "A" # optional
|
|
|
|
|
|
|
|
|
|
### Dns server port. 53 is default
|
|
|
|
|
port = 53 # optional
|
|
|
|
|
|
|
|
|
|
### Query timeout in seconds. Default is 2 seconds
|
|
|
|
|
timeout = 2 # optional
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
For querying more than one record type make:
|
|
|
|
|
|
|
|
|
|
```
|
2016-02-15 15:10:04 +00:00
|
|
|
[[inputs.dns_query]]
|
2016-02-13 18:00:42 +00:00
|
|
|
domains = ["mjasion.pl"]
|
|
|
|
|
servers = ["8.8.8.8", "8.8.4.4"]
|
|
|
|
|
recordType = "A"
|
|
|
|
|
|
2016-02-15 15:10:04 +00:00
|
|
|
[[inputs.dns_query]]
|
2016-02-13 18:00:42 +00:00
|
|
|
domains = ["mjasion.pl"]
|
|
|
|
|
servers = ["8.8.8.8", "8.8.4.4"]
|
|
|
|
|
recordType = "MX"
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Tags:
|
|
|
|
|
|
|
|
|
|
- server
|
|
|
|
|
- domain
|
|
|
|
|
- recordType
|
|
|
|
|
|
|
|
|
|
### Example output:
|
|
|
|
|
|
|
|
|
|
```
|
2016-02-15 15:10:04 +00:00
|
|
|
./telegraf -config telegraf.conf -test -input-filter dns_query -test
|
|
|
|
|
> dns,domain=mjasion.pl,record_type=A,server=8.8.8.8 query_time_ms=36.327025 1455548824989943491
|
2016-02-13 18:00:42 +00:00
|
|
|
```
|
