BIND 9 名称服务器输入插件
此插件使用 XML 或 JSON 端点从 BIND 9 名称服务器收集指标。
对于XML，支持版本 2（BIND 9.6 至 9.9）和版本 3（BIND 9.9+）的统计信息。版本 3 统计信息是 BIND 9.10+ 的默认且唯一支持的 XML 格式。
为了让 BIND 9.9 支持版本 3 统计信息，它必须使用 --enable-newstats 编译标志构建，并且必须通过正确的 URL 指定统计信息。
对于JSON，支持版本 1（BIND 9.10+）的统计信息。撰写本文时，一些发行版尚未在其 BIND 包中启用 JSON 统计信息支持。
引入于: Telegraf v1.11.0 标签: server 操作系统支持: all
全局配置选项
插件支持其他全局和插件配置设置，用于修改指标、标签和字段，创建别名以及配置插件顺序等任务。更多详情请参阅 CONFIGURATION.md。
配置
# Read BIND nameserver XML statistics
[[inputs.bind]]
## An array of BIND XML statistics URI to gather stats.
## Default is "https://:8053/xml/v3".
# urls = ["https://:8053/xml/v3"]
# gather_memory_contexts = false
# gather_views = false
## Report xml v3 counters as integers instead of unsigned for backward
## compatibility. Set this to false as soon as possible!
## Values are clipped if exceeding the integer range.
# report_counters_as_int = true
## Timeout for http requests made by bind nameserver
# timeout = "4s"- urls []string: 要从中收集数据的 BIND 统计信息通道 URL 列表。URL 末尾不要包含斜杠。默认为
https://:8053/xml/v3。 - gather_memory_contexts bool: 报告每个上下文的内存统计信息。
- gather_views bool: 报告每个视图的查询统计信息。
- timeout bind 发起的 http 请求的超时时间（例如：“4s”）。
下表总结了应使用的 URL 格式，具体取决于您的 BIND 版本和配置的统计信息通道。
| BIND 版本 | 统计信息格式 | 示例 URL |
|---|---|---|
| 9.6 - 9.8 | XML v2 | https://:8053 |
| 9.9 | XML v2 | https://:8053/xml/v2 |
| 9.9+ | XML v3 | https://:8053/xml/v3 |
| 9.10+ | JSON v1 | https://:8053/json/v1 |
BIND Daemaon 的配置
如果您在与 BIND daemon 相同的宿主机上运行 Telegraf，请将以下内容添加到您的 named.conf 中。
statistics-channels {
inet 127.0.0.1 port 8053;
};或者，指定一个通配符地址（例如 0.0.0.0）或接口的特定 IP 地址，以配置 BIND daemon 在该地址上监听。请注意，如果统计信息通道是公开可访问的，您应该使用 ACL 来保护它。有关更多信息，请参阅 BIND 管理员参考手册。
Metrics
- bind_counter
- 标签 (tags)
- url
- source
- port
- type
- view (可选)
- 字段 (fields)
- dynamic, record type name (multiple)
- 标签 (tags)
- bind_memory
- 标签 (tags)
- url
- source
- port
- 字段 (fields)
- total_use
- in_use
- block_size
- context_size
- lost
- 标签 (tags)
- bind_memory_context
- 标签 (tags)
- url
- source
- port
- id
- name
- 字段 (fields)
- total
- in_use
- 标签 (tags)
示例输出
以下是此插件的示例输出
bind_memory,host=LAP,port=8053,source=localhost,url=localhost:8053 block_size=12058624i,context_size=4575056i,in_use=4113717i,lost=0i,total_use=16663252i 1554276619000000000
bind_counter,host=LAP,port=8053,source=localhost,type=opcode,url=localhost:8053 IQUERY=0i,NOTIFY=0i,QUERY=9i,STATUS=0i,UPDATE=0i 1554276619000000000
bind_counter,host=LAP,port=8053,source=localhost,type=rcode,url=localhost:8053 17=0i,18=0i,19=0i,20=0i,21=0i,22=0i,BADCOOKIE=0i,BADVERS=0i,FORMERR=0i,NOERROR=7i,NOTAUTH=0i,NOTIMP=0i,NOTZONE=0i,NXDOMAIN=0i,NXRRSET=0i,REFUSED=0i,RESERVED11=0i,RESERVED12=0i,RESERVED13=0i,RESERVED14=0i,RESERVED15=0i,SERVFAIL=2i,YXDOMAIN=0i,YXRRSET=0i 1554276619000000000
bind_counter,host=LAP,port=8053,source=localhost,type=qtype,url=localhost:8053 A=1i,ANY=1i,NS=1i,PTR=5i,SOA=1i 1554276619000000000
bind_counter,host=LAP,port=8053,source=localhost,type=nsstat,url=localhost:8053 AuthQryRej=0i,CookieBadSize=0i,CookieBadTime=0i,CookieIn=9i,CookieMatch=0i,CookieNew=9i,CookieNoMatch=0i,DNS64=0i,ECSOpt=0i,ExpireOpt=0i,KeyTagOpt=0i,NSIDOpt=0i,OtherOpt=0i,QryAuthAns=7i,QryBADCOOKIE=0i,QryDropped=0i,QryDuplicate=0i,QryFORMERR=0i,QryFailure=0i,QryNXDOMAIN=0i,QryNXRedir=0i,QryNXRedirRLookup=0i,QryNoauthAns=0i,QryNxrrset=1i,QryRecursion=2i,QryReferral=0i,QrySERVFAIL=2i,QrySuccess=6i,QryTCP=1i,QryUDP=8i,RPZRewrites=0i,RateDropped=0i,RateSlipped=0i,RecQryRej=0i,RecursClients=0i,ReqBadEDNSVer=0i,ReqBadSIG=0i,ReqEdns0=9i,ReqSIG0=0i,ReqTCP=1i,ReqTSIG=0i,Requestv4=9i,Requestv6=0i,RespEDNS0=9i,RespSIG0=0i,RespTSIG=0i,Response=9i,TruncatedResp=0i,UpdateBadPrereq=0i,UpdateDone=0i,UpdateFail=0i,UpdateFwdFail=0i,UpdateRej=0i,UpdateReqFwd=0i,UpdateRespFwd=0i,XfrRej=0i,XfrReqDone=0i 1554276619000000000
bind_counter,host=LAP,port=8053,source=localhost,type=zonestat,url=localhost:8053 AXFRReqv4=0i,AXFRReqv6=0i,IXFRReqv4=0i,IXFRReqv6=0i,NotifyInv4=0i,NotifyInv6=0i,NotifyOutv4=0i,NotifyOutv6=0i,NotifyRej=0i,SOAOutv4=0i,SOAOutv6=0i,XfrFail=0i,XfrSuccess=0i 1554276619000000000
bind_counter,host=LAP,port=8053,source=localhost,type=sockstat,url=localhost:8053 FDWatchClose=0i,FDwatchConn=0i,FDwatchConnFail=0i,FDwatchRecvErr=0i,FDwatchSendErr=0i,FdwatchBindFail=0i,RawActive=1i,RawClose=0i,RawOpen=1i,RawOpenFail=0i,RawRecvErr=0i,TCP4Accept=6i,TCP4AcceptFail=0i,TCP4Active=9i,TCP4BindFail=0i,TCP4Close=5i,TCP4Conn=0i,TCP4ConnFail=0i,TCP4Open=8i,TCP4OpenFail=0i,TCP4RecvErr=0i,TCP4SendErr=0i,TCP6Accept=0i,TCP6AcceptFail=0i,TCP6Active=2i,TCP6BindFail=0i,TCP6Close=0i,TCP6Conn=0i,TCP6ConnFail=0i,TCP6Open=2i,TCP6OpenFail=0i,TCP6RecvErr=0i,TCP6SendErr=0i,UDP4Active=18i,UDP4BindFail=14i,UDP4Close=14i,UDP4Conn=0i,UDP4ConnFail=0i,UDP4Open=32i,UDP4OpenFail=0i,UDP4RecvErr=0i,UDP4SendErr=0i,UDP6Active=3i,UDP6BindFail=0i,UDP6Close=6i,UDP6Conn=0i,UDP6ConnFail=6i,UDP6Open=9i,UDP6OpenFail=0i,UDP6RecvErr=0i,UDP6SendErr=0i,UnixAccept=0i,UnixAcceptFail=0i,UnixActive=0i,UnixBindFail=0i,UnixClose=0i,UnixConn=0i,UnixConnFail=0i,UnixOpen=0i,UnixOpenFail=0i,UnixRecvErr=0i,UnixSendErr=0i 1554276619000000000此页面是否有帮助？
感谢您的反馈！
支持和反馈
感谢您成为我们社区的一员！我们欢迎并鼓励您对 Telegraf 和本文档提出反馈和 bug 报告。要获取支持，请使用以下资源
具有年度合同或支持合同的客户可以 联系 InfluxData 支持。