ACK集群的ACK CoreDNS DNSTAP Analyser组件，可以从CoreDNS和客户端之间，CoreDNS和上游DNS服务器之间的请求和响应过程中，对所有产生的DNS网络报文进行归类和识别。借助此工具，您可以快速定位域名无法解析的原因。本文介绍如何使用ACK CoreDNS DNSTAP Analyser诊断CoreDNS域名解析异常。

背景信息

DNSTAP是一种DNS报文日志格式协议，可以被用于诊断DNS服务器上异常解析问题。更多信息，请参见dnstap。

步骤一：安装ACK CoreDNS DNSTAP Analyser

  1. 登录容器服务管理控制台。
  2. 在控制台左侧导航栏中，选择市场 > 应用市场。
  3. 在应用目录页签搜索ack-coredns-dnstap-analyser，找到并单击ack-coredns-dnstap-analyser。
  4. 在ack-coredns-dnstap-analyser页面，单击一键部署。
  5. 在创建面板中选择目标集群和命名空间，然后单击下一步。在参数配置页签中根据需求设置参数，然后单击确定。

步骤二：配置CoreDNS的DNSTAP插件

CoreDNS中内置了发送DNSTAP报文的DNSTAP插件，DNSTAP插件收到和发出的DNS报文可以发送至ACK CoreDNS DNSTAP Analyser。使用ACK CoreDNS DNSTAP Analyser诊断CoreDNS域名解析异常前，您需要先配置CoreDNS的DNSTAP插件。

  1. 执行以下命令，获取kube-system命名空间下ACK CoreDNS DNSTAP Analyser服务的ClusterIP地址（例如172.21.0.10）用于配置DNSTAP插件。
    kubectl -n kube-system get svc dnstap-analyser
  2. 执行以下命令，编辑CoreDNS配置文件。
    kubectl -n kube-system edit cm coredns -o yaml
  3. 参考以下注释修改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
        }
  4. 执行以下命令，查看当前CoreDNS的所有容器组。
    kubectl -n kube-system get pod | grep coredns
    预期输出：
    coredns-7d56l         1/1     Running   0          30m
coredns-s7m2t         1/1     Running   0          30m
  5. 执行以下命令，持续查看CoreDNS日志。
    kubectl -n kube-system logs -f --tail=500 coredns-7d56l
    说明 替换容器组名称coredns-7d56l为步骤3中出现的任意一容器组名称。
    等待约一分钟，观察日志中出现以下输出，并无其它异常时，说明配置修改成功。
    [INFO] Reloading complete

通过以上操作您已启用CoreDNS DNSTAP插件，此时CoreDNS会将接收和发送到的DNS报文转发至ACK CoreDNS DNSTAP Analyser进行自动化诊断。

步骤三：查看ACK CoreDNS DNSTAP Analyser日志

  1. 执行以下命令，查看ACK CoreDNS DNSTAP Analyser的所有容器组。
    kubectl -n kube-system get pod | grep dnstap-analyser
    预期输出：
    dnstap-analyser-bbdf879-g****         1/1     Running   0          30m
  2. 执行以下命令，查看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报文信息

  1. 登录容器服务管理控制台。
  2. 在控制台左侧导航栏中，单击集群。
  3. 在集群列表页面中，单击目标集群名称或者目标集群右侧操作列下的详情。
  4. 在集群信息页面，单击集群资源页签，然后单击日志服务Project右侧的日志服务Project名称链接。
  5. 在日志库页面左侧导航栏，单击仪表盘图标dashboard。在仪表盘列表中找到并单击Kubernetes CoreDNS DNSTAP 报文监控。
    在Kubernetes CoreDNS DNSTAP 报文监控页面，您可以查看报文数量和异常报文情况。报表信息
  6. 可选：当出现异常报文需要查看详情时，请按照如下步骤操作。
    1. 请记录报文 ID。
    2. 在日志库页面左侧导航栏，单击日志存储图标日志存储。
    3. 在左侧日志库中单击安装时设置的日志库，如果使用了默认日志库k8s-coredns-dnstap，则单击默认日志库。
    4. 在查询页面搜索报文 ID。报文ID
    5. 如果仍有疑问，需要工单协助时，请单击日志条目时间右侧的复制按钮复制，复制后提交工单申请协助。

（可选）步骤六：卸载 DNSTap

定位到原因后，建议您卸载DNSTap以避免不必要的日志开销，卸载流程如下。

  1. 删除CoreDNS配置文件中包含dnstap一行。
    1. 执行以下命令，编辑CoreDNS配置文件。
      kubectl -n kube-system edit cm coredns -o yaml
    2. 参考以下注释删除CoreDNS配置文件中包含dnstap一行。
      Corefile: |
        .:53 {
            #省略
            ready

            #删除以下一行
            dnstap tcp://10.10.10.10:6000 full

            kubernetes cluster.local in-addr.arpa ip6.arpa {
            #省略
            }
            #省略
            reload
            loadbalance
        }
    3. 执行以下命令，查看当前CoreDNS的所有容器组。
      kubectl -n kube-system get pod | grep coredns

      预期输出：

      coredns-7d56l         1/1     Running   0          30m
coredns-s7m2t         1/1     Running   0          30m
    4. 执行以下命令，持续查看CoreDNS日志。
      kubectl -n kube-system logs -f --tail=500 coredns-7d56l
      说明 替换容器组名称coredns-7d56l为步骤iii中出现的任意一容器组名称。
      等待约一分钟，观察日志中出现以下输出，并无其它异常时，说明配置修改成功。
      [INFO] Reloading complete
  2. 卸载 ack-coredns-dnstap-analyser 组件。
    1. 登录容器服务管理控制台。
    2. 在控制台左侧导航栏中，单击集群。
    3. 在集群列表页面中，单击目标集群名称或者目标集群右侧操作列下的详情。
    4. 在集群管理页左侧导航栏中，单击应用 > Helm。
    5. 在Helm页面，单击ack-coredns-dnstap-analyser操作列的删除。
    6. 在弹出框中单击确定。