---
title: ''
description: Telegraf plugin for collecting metrics from DNS Query
url: https://docs.influxdata.com/telegraf/v1/input-plugins/dns_query/
estimated_tokens: 1029
product: Telegraf Enterprise
version: v1
publisher: InfluxData
canonical: https://docs.influxdata.com/telegraf/v1/input-plugins/dns_query/
date: '2026-05-21T20:10:18+02:00'
lastmod: '2026-05-21T20:10:18+02:00'
---

==========

* Telegraf v1.4.0+

[Plugin source](https://github.com/influxdata/telegraf/tree/v1.39.1/plugins/inputs/dns_query/)[Download configuration](https://raw.githubusercontent.com/influxdata/telegraf/refs/tags/v1.39.1/plugins/inputs/dns_query/sample.conf)

# DNS Query Input Plugin

This plugin gathers information about DNS queries such as response time and
result codes.

**Introduced in:** Telegraf v1.4.0**Tags:** system, network**OS support:** all

## Global configuration options

Plugins support additional global and plugin configuration settings for tasks
such as modifying metrics, tags, and fields, creating aliases, and configuring
plugin ordering. See [CONFIGURATION.md](/telegraf/v1/configuration/#plugins) for more details.

## Configuration

```toml
# 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.
  ## Possible values: A, AAAA, CNAME, MX, NS, PTR, TXT, SOA, SPF, SRV.
  # record_type = "A"

  ## Dns server port.
  # port = 53

  ## Query timeout
  # timeout = "2s"

  ## Include the specified additional properties in the resulting metric.
  ## The following values are supported:
  ##    "first_ip" -- return IP of the first A and AAAA answer
  ##    "all_ips"  -- return IPs of all A and AAAA answers
  # include_fields = []
```

## Metrics

* dns\_query
  * tags:
    * server
    * domain
    * record\_type
    * result
    * rcode

  * fields:
    * query\_time\_ms (float)
    * result\_code (int, success = 0, timeout = 1, error = 2)
    * rcode\_value (int)

## Rcode Descriptions

|rcode\_value|  rcode  |           Description           |
|------------|---------|---------------------------------|
|     0      | NoError |            No Error             |
|     1      | FormErr |          Format Error           |
|     2      |ServFail |         Server Failure          |
|     3      |NXDomain |       Non-Existent Domain       |
|     4      | NotImp  |         Not Implemented         |
|     5      | Refused |          Query Refused          |
|     6      |YXDomain | Name Exists when it should not  |
|     7      | YXRRSet |RR Set Exists when it should not |
|     8      | NXRRSet |RR Set that should exist does not|
|     9      | NotAuth |Server Not Authoritative for zone|
|     10     | NotZone |   Name not contained in zone    |
|     16     | BADSIG  |     TSIG Signature Failure      |
|     16     | BADVERS |         Bad OPT Version         |
|     17     | BADKEY  |       Key not recognized        |
|     18     | BADTIME |  Signature out of time window   |
|     19     | BADMODE |          Bad TKEY Mode          |
|     20     | BADNAME |       Duplicate key name        |
|     21     | BADALG  |     Algorithm not supported     |
|     22     |BADTRUNC |         Bad Truncation          |
|     23     |BADCOOKIE|    Bad/missing Server Cookie    |

## Example Output

```text
dns_query,domain=google.com,rcode=NOERROR,record_type=A,result=success,server=127.0.0.1 rcode_value=0i,result_code=0i,query_time_ms=0.13746 1550020750001000000
```
| rcode_value | rcode | Description |
| --- | --- | --- |
| rcode_value | rcode | Description |
| 0 | NoError | No Error |
| 1 | FormErr | Format Error |
| 2 | ServFail | Server Failure |
| 3 | NXDomain | Non-Existent Domain |
| 4 | NotImp | Not Implemented |
| 5 | Refused | Query Refused |
| 6 | YXDomain | Name Exists when it should not |
| 7 | YXRRSet | RR Set Exists when it should not |
| 8 | NXRRSet | RR Set that should exist does not |
| 9 | NotAuth | Server Not Authoritative for zone |
| 10 | NotZone | Name not contained in zone |
| 16 | BADSIG | TSIG Signature Failure |
| 16 | BADVERS | Bad OPT Version |
| 17 | BADKEY | Key not recognized |
| 18 | BADTIME | Signature out of time window |
| 19 | BADMODE | Bad TKEY Mode |
| 20 | BADNAME | Duplicate key name |
| 21 | BADALG | Algorithm not supported |
| 22 | BADTRUNC | Bad Truncation |
| 23 | BADCOOKIE | Bad/missing Server Cookie |