收集 TCP 服务指标
本文任务展示了如何对 Istio 进行配置,从而自动收集网格中 TCP 服务的遥测数据。在任务最后,会为网格中的一个 TCP 服务启用一个新的指标。
在本例中会使用 Bookinfo 作为示例应用。
开始之前
在集群中安装 Istio 并部署一个应用。
任务中假设 Bookinfo 应用部署在
default
命名空间中。如果使用不同的命名空间,需要更新例子中的相关配置和命令。
收集新的遥测数据
创建一个新的 YAML 文件用于配置新的指标,Istio 会据此文件生成并自动收集新建指标。
$ kubectl apply -f @samples/bookinfo/telemetry/tcp-metrics.yaml@
设置 Bookinfo 使用 Mongodb。
安装
ratings
服务的v2
版本。如果使用的是启用了 Sidecar 自动注入的集群,可以简单使用
kubectl
进行服务部署:$ kubectl apply -f @samples/bookinfo/platform/kube/bookinfo-ratings-v2.yaml@
如果使用手工的 Sidecar 注入方式,就需要使用下面的命令:
$ kubectl apply -f <(istioctl kube-inject -f @samples/bookinfo/platform/kube/bookinfo-ratings-v2.yaml@) deployment "ratings-v2" configured
安装
mongodb
服务:如果使用的是启用了 Sidecar 自动注入的集群,可以简单使用
kubectl
进行服务部署:$ kubectl apply -f @samples/bookinfo/platform/kube/bookinfo-db.yaml@
如果使用手工的 Sidecar 注入方式,就需要使用下面的命令:
$ kubectl apply -f <(istioctl kube-inject -f @samples/bookinfo/platform/kube/bookinfo-db.yaml@) service "mongodb" configured deployment "mongodb-v1" configured
Bookinfo 示例部署了每个微服务的多个版本,因此您将首先创建目标规则定义每个版本对应的服务子集,以及每个子集的负载均衡策略。
$ kubectl apply -f @samples/bookinfo/networking/destination-rule-all.yaml@
如果您启用了双向 TLS,请执行以下操作
$ kubectl apply -f @samples/bookinfo/networking/destination-rule-all-mtls.yaml@
您可以使用以下命令显示目标规则:
$ kubectl get destinationrules -o yaml
由于虚拟服务中的子集引用依赖于目标规则, 在添加引用这些子集的虚拟服务之前,请等待几秒钟以使目标规则传播。
创建
ratings
以及reviews
两个虚拟服务:$ kubectl apply -f @samples/bookinfo/networking/virtual-service-ratings-db.yaml@ Created config virtual-service/default/reviews at revision 3003 Created config virtual-service/default/ratings at revision 3004
向应用发送流量。
对于 Bookinfo 应用来说,在浏览器中浏览
http://$GATEWAY_URL/productpage
,或者使用下面的命令:$ curl http://$GATEWAY_URL/productpage
检查是否已经生成并收集了新的指标。
在 Kubernetes 环境中,使用下面的命令为 Prometheus 设置端口转发:
$ kubectl -n istio-system port-forward $(kubectl -n istio-system get pod -l app=prometheus -o jsonpath='{.items[0].metadata.name}') 9090:9090 &
在 Prometheus 浏览器窗口查看新指标的值。选择 Graph。 输入
istio_mongo_received_bytes
指标并选择 Execute。 在 Console 标签页中显示的表格包含了类似如下的内容:istio_mongo_received_bytes{destination_version="v1",instance="172.17.0.18:42422",job="istio-mesh",source_service="ratings-v2",source_version="v2"}
理解 TCP 遥测数据的收集过程
这一任务中,我们加入了一段 Istio 配置,对于所有目标为网格内 TCP 服务的流量,Mixer 自动为其生成并报告新的指标。
类似收集指标和日志任务中的情况,新的配置由 _instance_、一个 handler 以及一个 rule 构成。请参看该任务来获取关于指标收集的组件的完整信息。
instances 中属性集的可选范围不同,是 TCP 服务的指标收集过程的唯一差异。
TCP 属性
TCP 相关的属性是 Istio 中 TCP 策略和控制的基础。这些属性是由服务端的 Envoy 代理生成的。它们在连接建立时发给 Mixer,在连接的存活期间周期性的进行发送(周期性报告),最后在连接关闭时再次发送(最终报告)。周期性报告的缺省间隔时间为 10 秒钟,最小取值为 1 秒。另外上下文属性让策略有了区分 http
和 tcp
协议的能力。
清除
删除新的遥测配置:
$ kubectl delete -f @samples/bookinfo/telemetry/tcp-metrics.yaml@
如果您使用的是 Istio 1.1.2 或更低版本:
$ kubectl delete -f @samples/bookinfo/telemetry/tcp-metrics-crd.yaml@
删除
port-forward
进程:$ killall kubectl
如果不准备进一步探索其他任务,请参照 Bookinfo 清除,关闭示例应用。