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:
|
2018-05-08 01:18:01 +00:00
|
|
|
```toml
|
|
|
|
# Query given DNS server and gives statistics
|
2016-02-15 15:10:04 +00:00
|
|
|
[[inputs.dns_query]]
|
2016-02-21 17:43:24 +00:00
|
|
|
## servers to query
|
2017-07-21 23:56:08 +00:00
|
|
|
servers = ["8.8.8.8"]
|
2016-02-13 18:00:42 +00:00
|
|
|
|
2017-07-21 23:56:08 +00:00
|
|
|
## Network is the network protocol name.
|
|
|
|
# network = "udp"
|
2016-02-21 17:43:24 +00:00
|
|
|
|
2017-07-21 23:56:08 +00:00
|
|
|
## Domains or subdomains to query.
|
|
|
|
# domains = ["."]
|
2016-02-13 18:00:42 +00:00
|
|
|
|
2017-07-21 23:56:08 +00:00
|
|
|
## Query record type.
|
|
|
|
## Posible values: A, AAAA, CNAME, MX, NS, PTR, TXT, SOA, SPF, SRV.
|
|
|
|
# record_type = "A"
|
2016-02-13 18:00:42 +00:00
|
|
|
|
2017-07-21 23:56:08 +00:00
|
|
|
## Dns server port.
|
|
|
|
# port = 53
|
|
|
|
|
|
|
|
## Query timeout in seconds.
|
|
|
|
# timeout = 2
|
2016-02-13 18:00:42 +00:00
|
|
|
```
|
|
|
|
|
2018-05-08 01:18:01 +00:00
|
|
|
### Metrics:
|
2016-02-13 18:00:42 +00:00
|
|
|
|
2018-05-08 01:18:01 +00:00
|
|
|
- dns_query
|
|
|
|
- tags:
|
|
|
|
- server
|
|
|
|
- domain
|
|
|
|
- record_type
|
|
|
|
- result
|
|
|
|
- fields:
|
|
|
|
- query_time_ms (float)
|
|
|
|
- result_code (int, success = 0, timeout = 1, error = 2)
|
2016-02-13 18:00:42 +00:00
|
|
|
|
2018-05-08 01:18:01 +00:00
|
|
|
### Example Output:
|
2016-02-13 18:00:42 +00:00
|
|
|
|
|
|
|
```
|
2018-05-08 01:18:01 +00:00
|
|
|
dns_query,domain=mjasion.pl,record_type=A,server=8.8.8.8 query_time_ms=67.189842 1456082743585760680
|
2016-02-13 18:00:42 +00:00
|
|
|
```
|