KubeSphere v3.1.0 通过集成 KubeEdge，将节点和资源的管理延伸到了边缘，也是 KubeSphere 正式支持边缘计算的第一个版本。
笔者也第一时间搭建和试用了边缘节点相关的功能，但是在边缘节点纳管之后遇到了一些监控的小问题，在排查过程中也顺带了解了一下 KubeSphere 对于边缘节点的监控原理，发出来和大家分享，方便其他的开发者能够更快的排查问题或进行二次开发。
环境版本和构成
通过 KubeKey 安装，参数如下，其余组件版本默认未改动。
Kubernetes : v1.19.8
KubeSphere : v3.1.0
| 主机名称 | 角色 |
|---|---|
| k8s-worker-03 | worker |
| k8s-worker-02 | master |
| k8s-worker-01 | master,etcd |
问题现象
通过生成的 keadm 命令行将边缘节点加入集群，并在边缘节点上部署 POD，该 POD 的监控信息不能显示。
监控原理
定位和解决问题之前，肯定是要先搞懂工作原理。
1. KubeEdge
KubeEdge 的 Edgecore 组件对 Kubelet 进行了轻量化改造，Edgecore 和 Cloudcore(云端)也不在同一个 Cluster 网络中，通过 k8s 默认的方式进行 metrics 获取肯定是行不通的(logs 和 exec 原理相同)。
当前 KubeEdge 的实现方法是 kube-apiserver 上的 iptables 转发给云端的 Cloudcore，Cloudcore 通过和 Edgecore 之间的 WebSocket 通道向边缘端进行消息和数据传递。
KubeEdge 官方的使用手册和文档：https://kubeedge.io/en/docs/advanced/metrics/
为了便于大家理解，作者画了一张图，整体的流程请参考如下：
2. Metrics-server
原生的 K8S 中就是通过 Metrics-server 这个官方组件进行节点和 POD 的 CPU/Memory 等数据的监控。
简而言之，Metrics-server 通过 Pull 的方式去每个节点上拉取监控数据，放在自身的内存中，提供 K8S 的 API 供 kubectl top 这样的 client 来查询。
Metrics-server 的详细设计，可以参考 github 的官方说明：https://github.com/kubernetes-sigs/metrics-server
Metrcis-server 的启动参数中，有一个参数要特别说明一下："kubelet-use-node-status-port"。
在 KubeEdge 的官方文档中，也提到了启动 Metrics-server 时要指定该参数，至于原因文档中并未提及，这里简单说明一下。这个参数的意思是：“调用 kubelet 服务时，用该 Node 上报的 port，而不是默认的 port”。我们知道 kubelet 的 metrcis 接口默认是监听在 10250 端口的，而 KubeEdge 的 edgecore 将 metrics 接口默认监听在 10350 端口，如果不加这个参数，metrice-server 就会通过类似"edgenodeIP:10250/stat/summary"这样的请求去获取监控数据，结果肯定获取失败的。
我们通过 KubeSphere 环境的 yaml 文件，也能清晰地看到这一点配置：
3. KubeSphere
上面讲到了，Metrics-server 已经从 KubeEdge 那里获取到了边缘节点的监控数据，那么 KubeSphere 只要从 Metrics-server 提供的 K8S API 中即可获取到边缘节点的实时监控数据用来在前端进行展示。
稍微翻了一下 KubeSphere 的代码，和我们的预想是一致的，KubeSphere 通过 metrics-server 拿到了当前版本展示的监控数据。
4. EdgeWatcher
从上述第 1 点 KubeEdge 的工作原理来看，是需要在 kube-apiserver 所在的节点上进行 iptables 转发规则设置的(将所有 10350 的请求都转发给 Cloudcore 的 10003 端口进行处理)。
那么每一个边缘节点加入集群的时候不可能由运维人员手动进行 iptables 的规则设置，所以 KubeSphere 就自研了 EdgeWatcher 这样一个组件。这个组件的目的应该是有以下几点：
- 提供 kubeedge group API(添加边缘节点时前端调用该 group API)
- 边缘节点加入集群时，设置 IPtables 规则(logs exec metrics 都需要)
- 验证边缘节点指定的 IP 是否可用，IP 需要全局唯一
EdgeWatcher 暂未开源，作者从社区转载了下面这张 EdgeWatcher 的工作原理图，供大家参考：
关于边缘节点 IP 需要全局唯一的问题，作者还是有很多想说的，后续有时间再开一篇，和大家一起探讨。
5. 总体概览
其实通过对上述监控组件的了解，我们也基本能勾勒出 KubeSphere v3.1 在基于 KubeEdge 的边缘集成中，所作的努力和工作。下面是作者简单画的一张整体组件架构的图，供大家参考：
问题定位
既然原理都搞清楚了，下面就简单说一下定位的过程和思路。
1. Metrics-server
首先我们判断 metrics-server 有没有正常提供服务，能不能获取到边缘数据。
从下面的命令结果可以看出，边缘节点(k8s-agent)的监控数据和非边缘节点的 POD 的监控数据都是没有问题的。
只有边缘节点上的 POD 的监控数据获取不到。
2. KubeEdge
再来看 KubeEdge 提供的 10350 端口的 metrics 服务，有没有问题。
我们可以看到，KubeEdge 的 edgecore 提供的 10350 端口的服务也是没有问题的，可以从中获取到边缘节点和边缘 POD(nginx-xxx)的监控数据。
3. 总结
从上面的分析可以得出以下结论：
- Metrcis-server 没问题
- KubeEdge 的 edgecore 在边缘节点的服务没问题
- cloudcore 和 edgecore 之间的通路没有问题(通过查看 edgecore 的日志，可以看到 stat/summary 的调用，但是 POD 的监控数据调用则没有)
最后再去确认其他可以获取边缘 POD 节点的信息，发现只有 docker 版本的差别，出问题的是 v18.09.1，而正常的节点版本如下：
至此，基本能断定是 docker 版本过低造成的，至于是哪个接口和 metrics-server 不能兼容，就不花太多时间去调查分析，有经验的开发者可以留言共享一下。
结论
基于这个问题，我们对 Docker 版本进行了测试，最终确认在 Kubesphere v3.1、 metrics-server 版本(v0.4.2)、 KubeEdge v1.6.1 的场景下，Docker 版本要大于等于 v19.3.0 才能支持边缘 POD 的监控。KubeEdge 官方最新版本 v1.7.1 已经发布，从 v1.6.2 的 Changelog 来看，该问题已经被修复了。造成该 pod metrics 丢失的原因，应该是 edgecore 使用的 K8s 版本过低导致的。详情可参考官方 KubeEdge v1.6.2的 Changelog。
后记
虽然问题不是很大，但是通过这个小问题能把边缘监控的脉络搞清楚，是比问题本身更有意义的。
通过这样的分析和总结，问题定位和二次开发的效率才会更高，希望我们社区的开发者一起把 KubeSphere 做得更好更完善。
本文由博客一文多发平台 OpenWrite 发布！