使用DNSTAP Analyser诊断异常
ACK集群的ACK CoreDNS DNSTAP Analyser组件，可以从CoreDNS和客户端之间，CoreDNS和上游DNS服务器之间的请求和响应过程中，对所有产生的DNS网络报文进行归类和识别。借助此工具，您可以快速定位域名无法解析的原因。本文介绍如何使用ACK CoreDNS DNSTAP Analyser诊断CoreDNS域名解析异常。
前提条件
背景信息
DNSTAP是一种DNS报文日志格式协议，可以被用于诊断DNS服务器上异常解析问题。更多信息，请参见dnstap。
步骤一：安装ACK CoreDNS DNSTAP Analyser
登录容器服务管理控制台。
在控制台左侧导航栏，选择。
在应用目录页签搜索ack-coredns-dnstap-analyser，找到并单击ack-coredns-dnstap-analyser。
在ack-coredns-dnstap-analyser页面，单击一键部署。
在创建面板中选择目标集群和命名空间，然后单击下一步。在参数配置页签中根据需求设置参数，然后单击确定。
步骤二：配置CoreDNS的DNSTAP插件
CoreDNS中内置了发送DNSTAP报文的DNSTAP插件，DNSTAP插件收到和发出的DNS报文可以发送至ACK CoreDNS DNSTAP Analyser。使用ACK CoreDNS DNSTAP Analyser诊断CoreDNS域名解析异常前，您需要先配置CoreDNS的DNSTAP插件。
执行以下命令，获取kube-system命名空间下ACK CoreDNS DNSTAP Analyser服务的ClusterIP地址（例如172.21.0.10）用于配置DNSTAP插件。
kubectl -n kube-system get svc dnstap-analyser执行以下命令，编辑CoreDNS配置文件。
kubectl -n kube-system edit cm coredns -o yaml参考以下注释修改CoreDNS的默认配置。
修改配置的目的是启用DNSTAP插件，并指向地址至CoreDNS DNSTAP Analyser的ClusterIP地址，从而将DNSTAP插件收到和发出的DNS报文发送至ACK CoreDNS DNSTAP Analyser。
Corefile: | .:53 { #省略 ready #添加以下一行，将172.21.0.10替换成获取到的CoreDNS DNSTAP Analyser ClusterIP地址。 dnstap tcp://172.21.0.10:6000 full kubernetes cluster.local in-addr.arpa ip6.arpa { #省略 } #省略 reload loadbalance }执行以下命令，查看当前CoreDNS的所有容器组。
kubectl -n kube-system get pod | grep coredns预期输出：
coredns-7d56l 1/1 Running 0 30m coredns-s7m2t 1/1 Running 0 30m执行以下命令，持续查看CoreDNS日志。
kubectl -n kube-system logs -f --tail=500 coredns-7d56l说明替换容器组名称coredns-7d56l为上述步骤4中出现的任意一个容器组名称。
等待约一分钟，观察日志中出现以下输出，并无其它异常时，说明配置修改成功。
[INFO] Reloading complete
通过以上操作您已启用CoreDNS DNSTAP插件，此时CoreDNS会将接收和发送到的DNS报文转发至ACK CoreDNS DNSTAP Analyser进行自动化诊断。
步骤三：查看ACK CoreDNS DNSTAP Analyser日志
执行以下命令，查看ACK CoreDNS DNSTAP Analyser的所有容器组。
kubectl -n kube-system get pod | grep dnstap-analyser预期输出：
dnstap-analyser-bbdf879-g**** 1/1 Running 0 30m执行以下命令，查看ACK CoreDNS DNSTAP Analyser日志。
kubectl -n kube-system logs -f dnstap-analyser-bbdf879-g****说明替换容器组名称dnstap-analyser-bbdf879-gpfkm为上述步骤1中出现的容器组名称。
步骤四：分析ACK CoreDNS DNSTAP Analyser日志
在ACK CoreDNS DNSTAP Analyser日志中，每一行是一个经过聚合的DNS请求上下文（Session），包含了从客户端、CoreDNS、上游DNS服务器之间的所有请求和响应的报文。DNS请求上下文（Session）包括：
Status字段：不同的Status代表不同的场景。
上下文状态
描述
Succeeded
完整的域名查询请求，域名的响应是正常的（状态为NXDOMAIN、NOERROR）。
Failed
有问题的域名查询请求，域名响应中状态码异常或上游服务器连接超时等情况。
SampleLoss
CoreDNS或Analyser负载较高，导致DNSTAP报文丢失，出现这类状态时，应调整CoreDNS或Analyser副本数，使单个容器的负载下降，提高诊断可信度。
BitMap字段：BitMap的值代表了该请求上下文中截取到的DNSTAP报文的种类，根据截取到的不同种类，得到可能的异常原因。
上下文Session BitMap值
含义
1
CoreDNS接收到了客户端的查询请求，但未返回结果给客户端。
3
一次完整的内部域名查询，从客户端发起了请求，CoreDNS本地缓存中或Kubernetes中存在命中该域名的解析结果，将结果返回给了客户端。
5
无法连接到上游服务器，从客户端发起了请求，CoreDNS将请求转发给上游服务器进行查询，上游服务器未返回结果。
15
一次完整的外部域名查询，从客户端发起了请求，CoreDNS将请求转发给上游服务器进行查询，上游服务器完成了查询并返回，CoreDNS又将结果返回给了客户端。
Messages字段：DNS请求上下文Session中Messages字段记录了DNS请求、响应的原始报文的JSON输出，可以根据dns-parameters-6对报文内容进行问题诊断。
（可选）步骤五：通过SLS仪表盘查看异常DNS报文信息
登录容器服务管理控制台。
在控制台左侧导航栏，单击集群。
在集群列表页面，单击目标集群名称或者目标集群右侧操作列下的详情。
在集群信息页面，单击集群资源页签，然后单击日志服务Project右侧的日志服务Project名称链接。
在日志库页面左侧导航栏，单击仪表盘图标
。在仪表盘列表中找到并单击Kubernetes CoreDNS DNSTAP 报文监控。在Kubernetes CoreDNS DNSTAP 报文监控页面，您可以查看报文数量和异常报文情况。
可选：当出现异常报文需要查看详情时，请按照如下步骤操作。
请记录报文 ID。
在日志库页面左侧导航栏，单击日志存储图标
。在左侧日志库中单击安装时设置的日志库，如果使用了默认日志库k8s-coredns-dnstap，则单击默认日志库。
在查询页面搜索报文 ID。
如果仍有疑问，需要工单协助时，请单击日志条目时间右侧的复制按钮
，复制后提交工单申请协助。
（可选）步骤六：卸载 DNSTap
定位到原因后，建议您卸载DNSTap以避免不必要的日志开销，卸载流程如下。
删除CoreDNS配置文件中包含dnstap一行。
执行以下命令，编辑CoreDNS配置文件。
kubectl -n kube-system edit cm coredns -o yaml参考以下注释删除CoreDNS配置文件中包含dnstap一行。
Corefile: | .:53 { #省略 ready #删除以下一行 dnstap tcp://10.10.10.10:6000 full kubernetes cluster.local in-addr.arpa ip6.arpa { #省略 } #省略 reload loadbalance }执行以下命令，查看当前CoreDNS的所有容器组。
kubectl -n kube-system get pod | grep coredns预期输出：
coredns-7d56l 1/1 Running 0 30m coredns-s7m2t 1/1 Running 0 30m执行以下命令，持续查看CoreDNS日志。
kubectl -n kube-system logs -f --tail=500 coredns-7d56l说明替换容器组名称coredns-7d56l为上述步骤c中出现的任意一个容器组名称。
等待约一分钟，观察日志中出现以下输出，并无其它异常时，说明配置修改成功。
[INFO] Reloading complete
卸载 ack-coredns-dnstap-analyser 组件。
登录容器服务管理控制台。
在控制台左侧导航栏，单击集群。
在集群列表页面，单击目标集群名称或者目标集群右侧操作列下的详情。
在集群管理页左侧导航栏中，单击。
在Helm页面，单击ack-coredns-dnstap-analyser操作列的删除。
在弹出框中单击确定。
