文档中心

托管 Prometheus

容器服务接入

容器集群接入

云原生观测服务能够提供免运维、高性能、高稳定的集群观测与告警服务。本文为您介绍如何开启集群中的云原生观测功能。

背景信息

云原生可观测功能基于托管 Prometheus 服务实现，使用 prometheus-agent 组件实现集群中的基础资源观测。因此，开启云原生可观测功能时，首先需要创建托管 Prometheus 工作区，并在集群中安装 prometheus-agent 组件。

采集器

云原生可观测使用 prometheus-agent 组件作为集群基础资源观测使用的采集器，当您在集群中安装 prometheus-agent 组件时，会同时安装 vm-agent、vmoperator、kube-state-metrics 和 node-exporter 组件。每个组件的名称、类型和作用如下表所示。

组件名称	负载类型	命名空间	说明
vmagent-prometheus-agent	StatefulSet	kube-system	采集器组件，采集集群内 kubelet、kubelet-cadvisor 、kube-state-metrics 、node-exporter、dcgm、ingress-nginx、p2p-accelerator 等暴露的指标。
prometheus-agent-vmoperator	Deployment	kube-system	vm-agent 控制组件。
prometheus-agent-kube-state-metrics	StatefulSet	kube-system	提供 Kubernetes 资源信息指标数据。
prometheus-agent-node-exporter	DaemonSet	kube-system	提供节点资源信息指标数据。

推荐规格

prometheus-agent 组件允许您自定义其资源和分片数，组件的分片数和规格与集群规模相关，您可以基于集群规模，配置组件的初始（最小）分片数。

vm-agent 采集器和 kube-state-metrics 组件在不同规模集群中的推荐初始（最小）分片数如下表所示。

集群规模	vm-agent 初始（最小）分片数	kube-state-metrics 初始（最小）分片数
10 Node，500 Pod	1	1
100 Node，5000 Pod	2	2
200 Node，10000 Pod	4	4
500 Node，25000 Pod	10	10

前提条件

已创建集群，详情请参见创建集群。

已创建托管 Prometheus 工作区，详情请参见创建工作区。

操作步骤

步骤一：集群绑定工作区

登录容器服务控制台。

在顶部导航栏，选择您业务所在地域。

在左侧导航栏单击集群，找到目标集群，单击集群名称。

在左侧导航栏单击总览，并选择运维配置页签。在配置页面中单击进行配置链接。

在弹出的配置框内，选择与集群绑定的托管 Prometheus 工作区。

说明

您也可以在创建集群时，绑定托管 Prometheus 工作区，详情请参见创建集群。

步骤二：部署采集器

在左侧导航栏中，选择组件管理。

选择监控页签，找到 prometheus-agent 组件，选择该组件右上角的 ... > 安装。

配置组件参数。

配置组件资源需求。

参数	描述
部署方式	组件的部署方式。当前该参数已固定，不可配置。
部署形态	容器网络模型为 VPC-CNI 的集群显示该参数。部署组件的节点类型，有如下两种方式：云服务器部署：表示在集群中的云服务器节点（Node）上部署该组件。弹性容器部署：表示在集群中的弹性容器实例（VCI），即虚拟节点（VirtualNode）上部署该组件。在弹性容器实例上部署组件，会产生费用，详细的费用说明，请参见弹性容器实例产品计费。
vm-agent 资源	配置 vm-agent 采集器的默认资源配置，包括：CPU 请求、CPU 上限、内存请求、内存上限。
kube-state-metrics 资源配置	配置 kube-state-metrics 组件的默认资源配置，包括：CPU 请求、CPU 上限、内存请求、内存上限。说明由于 kube-state-metrics 组件本身存在的限制（例如：每个组件实例允许采集的 Target 数量有限），在大规模集群中，建议优先使用增加分片数的方式，提升 kube-state-metrics 组件的指标采集能力。

配置组件的初始分片数和扩缩容。

参数	描述
vm-agent 初始分片数	配置 vm-agent 采集器的初始分片数。
kube-state-metrics 初始分片数	配置 kube-state-metrics 组件的初始分片数。
组件扩缩容	配置是否开启 vm-agent 采集器和 kube-state-metrics 组件的自动扩缩容功能。不开启：组件的分片数为配置的初始分片数。不会随着资源占用率的提升而自动扩容。开启：需要配置组件的最大分片数。组件会基于资源占用率自动扩缩容，具体逻辑如下： vm-agent 扩容：任一资源（CPU 或内存）使用率 > 70% 时，自动扩容。 vm-agent 缩容：全部资源（CPU 和内存）使用率均 < 30% 时，自动缩容。 kube-state-metrics 扩容：任一资源（CPU 或内存）使用率 > 70% 时，自动扩容。 kube-state-metrics 缩容：全部资源（CPU 和内存）使用率均 < 70% 时，自动缩容。注意 vm-agent 扩缩容冷却时间为 30 分钟。kube-state-metrics 基于 HPA 进行扩缩容量。配置组件自动扩缩容功能后，请保证集群资源充足，否则可能由于资源不足，导致组件扩容失败。 vm-agent 采集器和 kube-state-metrics 组件扩容时，为保证均衡负载，建议配置 kube-state-metrics 组件的分片数为 vm-agent 采集器分片数的整数倍，例如：kube-state-metrics 组件分片数：vm-agent 采集器分片数为 1:1 或 2:1 等。
部署插件	配置是否同步安装 node-exporter 插件，默认安装插件。该插件用于采集节点操作系统的各项软硬件指标；如果不安装，则无法监控节点指标。建议您保持默认值。说明 node-exporter 插件以 Daemonset 方式部署。因此，当您在弹性容器实例 VCI 场景中安装时，该插件会被部署在 ECS 节点上。更多信息，请参见 VCI 使用限制。

注意

当 Prometheus-agent 组件为 v2.0.1 及以前版本时，您还需要配置组件的托管 Prometheus 工作区，并配置工作区的认证用户名和密码。

当您配置组件的工作区时，需要保证配置的工作区与集群绑定的工作区一致。否则将无法在 Prometheus 监控页面中，查看集群监控的指标和大盘。

高级配置（需要升级 Prometheus-agent 版本至 v2.10.0 及以上）

参数	描述
Discovery Role	配置使用 Endpoints 或 EndpointSlices 服务发现方式。由于默认单个 Endpoints 只能支持最大 1K 的后端个数，在 Kubernetes 1.21 版本之后，引入了 EndpointSlices 资源规避了该问题，所以在 Prometheus 中也同步支持了 EndpointSlices 的服务发现方式。默认为 EndpointSlices，如果 Kubernetes 版本小于 v1.21，会自动使用 Endpoints 方式。
全局 Labels	采集 Prometheus-agent 默认给所有的采集指标添加的固定 Labels。注意只对由 Prometheus-agent 采集的指标生效，容器服控制面组件（例如：kube-apiserver 等）指标是由组件自行上报，不会被修改。如果新增或者修改全局 Labels，会导致活跃时序数增多（1小时内），如果指标规模较大，需要评估是否会达到活跃时序的限制。详情请参考工作区规格。警告默认自动添加的额外 Label 为cluster:<集群 ID>。该 Label 为系统保留字段，一般不建议覆盖。如果希望添加集群名称等，建议填写类似cluster_name的 Label。如果填写 cluster Label，会覆盖系统保留字段，造成的影响有：容器服务的监控看板里，可能存在部分面板无法展示指标。基于某些告警模版创建的告警规则会失效（由于其中cluster=~"$Cluster"的 Label 变动）。
Secret 权限	kube-state-metrics 需要在 ClusterRole 里包含 Secret 权限才能生成相关指标。

单击确定，完成配置。

步骤三：开启云原生观测

在集群管理页面的左侧导航栏中，选择云原生观测 > 概览，进入服务开通页面。

单击开启基础观测，开启云原生观测服务。

（可选）观测增强。允许一键开启集群中主要组件的观测，包括：core-dns、vpc-cni、ingress-nginx 等。也支持按需单独开启单个组件的观测，详情请参见基础观测。

（可选）网络和应用观测。支持在不侵入应用的前提下，观测工作负载的网络性能和各接口的应用性能，生成拓扑。并且可以进一步追踪响应错误或响应时间过长的接口调用。详情请参见网络和应用观测。

结果验证

查看观测配置

开启云原生观测功能后，选择观测概览页签，支持查看集群观测概览信息，包括：

观测配置概览：展示了集群绑定的托管 Prometheus 工作区和采集组件状态。

基础观测概览：展示了集群中已开启基础观测的组件比例和指标范围。具体说明，如下表所示。

配置项	说明
默认指标范围	配置集群中的观测指标范围，包括：基础：监控对象的基础指标，用于观测该对象的基础状态和资源使用情况。说明当使用 15 天存储时长的托管 Prometheus 工作区时，基础指标为免费指标。详情请参见按量计费。标准：（推荐）监控对象的基础指标 + 重要指标。在基础指标的基础上，增加了该观测对象的常用重要指标，能够更全面的获得观测对象的状态信息。全量：监控对象的基础指标 + 重要指标 + 高级指标，覆盖了该观测对象所有的指标。
基础指标开通率	所有已开通组件的基础指标开通率。支持单击去设置，选择或取消目标组件的采集指标。详情请参见基础观测。
非基础指标开通率	所有已开通组件的非基础指标开通率。支持单击去设置，选择或取消目标组件的采集指标。详情请参见基础观测。
观测增强	观测增强功能状态。支持单击，一键开启或关闭集群中主要组件的观测，包括：core-dns、vpc-cni、ingress-nginx 等。也支持按需单独开启单个组件的观测，详情请参见基础观测。说明控制台中绿色标记的组件，比如，表示该组件在集群中已安装。