56 lines
1.0 KiB
Markdown
56 lines
1.0 KiB
Markdown
# DNS Query Input Plugin
|
|
|
|
The DNS plugin gathers dns query times in miliseconds - like [Dig](https://en.wikipedia.org/wiki/Dig_\(command\))
|
|
|
|
### 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
|
|
```
|