文档文档

DNS 查询输入插件

此插件收集有关 DNS 查询的信息,例如响应时间和结果代码。

引入于: Telegraf v1.4.0 标签: system, network 操作系统支持: all

全局配置选项

插件支持其他全局和插件配置设置,用于修改指标、标签和字段,创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md

配置

# 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)
      • 服务器
      • domain
      • record_type
      • result
      • rcode
    • 字段 (fields)
      • query_time_ms (float)
      • result_code (int, success = 0, timeout = 1, error = 2)
      • rcode_value (int)

Rcode 描述

rcode_valuercode描述
0NoError无错误
1FormErr格式错误
2ServFail服务器失败
3NXDomain不存在的域名
4NotImp未实现
5Refused查询被拒绝
6YXDomain域名已存在(但不应存在)
7YXRRSetRR 集合已存在(但不应存在)
8NXRRSet应存在的 RR 集合不存在
9NotAuth服务器不对区域授权
10NotZone名称不属于区域
16BADSIGTSIG 签名失败
16BADVERS错误的 OPT 版本
17BADKEY密钥未识别
18BADTIME签名超出时间窗口
19BADMODE错误的 TKEY 模式
20BADNAME重复的密钥名称
21BADALG不支持的算法
22BADTRUNC错误的截断
23BADCOOKIE错误的/缺失的服务器 Cookie

示例输出

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

此页面是否有帮助?

感谢您的反馈!


InfluxDB 3.8 新特性

InfluxDB 3.8 和 InfluxDB 3 Explorer 1.6 的主要增强功能。

查看博客文章

InfluxDB 3.8 现已适用于 Core 和 Enterprise 版本,同时发布了 InfluxDB 3 Explorer UI 的 1.6 版本。本次发布着重于操作成熟度,以及如何更轻松地部署、管理和可靠地运行 InfluxDB。

更多信息,请查看

InfluxDB Docker 的 latest 标签将指向 InfluxDB 3 Core

在 **2026 年 2 月 3 日**,InfluxDB Docker 镜像的 latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。

如果使用 Docker 来安装和运行 InfluxDB,latest 标签将指向 InfluxDB 3 Core。为避免意外升级,请在您的 Docker 部署中使用特定的版本标签。例如,如果使用 Docker 运行 InfluxDB v2,请将 latest 版本标签替换为 Docker pull 命令中的特定版本标签 — 例如

docker pull influxdb:2