K8s 指标采集

最近更新时间:2025-11-04 16:26:42

我的收藏
本文将介绍如何将自建 K8s 和 TKE 集群(包含 TKE 标准集群和 TKE Serverless 集群)的指标采集至 CLS。

前提条件

已配置指标上报相关权限,详情请参见 指标上报访问策略模板
已创建日志集与指标主题,具体操作请参见 日志集指标主题

操作步骤

步骤1:选择指标主题

2. 在左侧导航栏中,选择指标主题,选择需要投递的指标主题,单击指标主题名称,进入指标主题详情页面。若您尚未创建指标主题,可单击创建指标主题进行创建,详情请参见 指标主题
3. 在指标主题详情页中,选中左侧菜单中的接入管理 > K8s 指标,此处提供 K8s 基础指标自定义服务指标的上报。可在右侧的管理页面中单击新建,即可进入对应 K8s 指标配置流程。


步骤2:配置 K8s 指标采集

K8s 基础监控指标采集
K8s 自定义服务指标采集
K8s 自定义服务指标采集(YAML 导入版)
1. 在右侧的 K8s 基础监控指标中单击新建,进入配置流程。
2. 选择需要采集的集群。若所选集群未开启指标采集,请鼠标 hover 到红字处。根据指引开启指标采集后,即可选择集群。

3. 进入配置页面后配置指标采集,此处提供快速配置和导入自定义 YAML 2种指标配置方式。

快速配置:
默认选中了部分常用的 K8s 基础监控指标,可单击修改进行调整。
提供三种基础指标分别为:容器用量监控、K8s 资源状态监控、主机监控。


自定义 YAML:支持通过 YAML 模板快速启用 Kubernetes 基础监控组件,采集集群、节点及容器层面的关键指标数据。提供三个可独立控制的采集组件开关,每个开关对应一个 YAML 部署模板,您可以根据实际业务场景进行 YAML 调整。
kube-state-metrics:采集 Kubernetes 资源对象(如 Deployment、Pod、Node)的运行状态信息。
node-exporter:采集节点层面的系统资源指标。
cAdvisor:采集容器运行时指标,用于监控 Pod 和容器的资源使用情况。


4. 配置完成后,单击提交,完成后即可开始采集。
1. 在右侧的 K8s 自定义服务指标中单击新建,进入配置流程。
2. 选择需要采集的集群。若所选集群未开启指标采集,请鼠标 hover 到红字处。根据指引开启指标采集后,即可选择集群。

3. 进入配置页面后配置指标采集。

采集配置部分内容见下方的表格。
参数
说明
配置名称
指标采集配置的名称。
采集对象
指标采集的目标 K8s 对象,支持选择多个。
命名空间:选择需要采集的命名空间。
Pod Label:通过 Label 选择目标 Pod,支持 key/value 配置,多条规则为 AND 关系。
端口(Port):指标采集端口。
Metric 地址(Path):指标采集的路径。

数据处理
用于对采集的指标数据进行规则处理,此处逻辑与 Prometheus 的 relabel 规则一致,支持配置多个数据梳理规则,多个规则按照规则序号 pipeline 执行。
规则操作支持:Label 替换、丢弃 Label、保留 Label、小写化、大写化、丢弃指标(完全/正则匹配)、保留指标(完全/正则匹配)、哈希取模、Label 映射等。

自定义 Label
除了原始的指标内容,还会带上容器或 Kubernetes 相关的元数据(例如:产生日志的容器 ID)一起上报到 CLS,方便用户查看指标时追溯来源或根据容器标识、特征(例如:容器名、labels)进行检索。您可以自行选择是否需要上报这些元数据,按需勾选上传,或者自定义元数据进行上报。

其他配置部分内容如下表。
参数
说明
通信协议
指标采集使用的协议,支持 HTTP 或 HTTPS,默认 HTTP。
采集频率
指标采集间隔,默认60s。
采集超时时间
指标采集请求超时时间,默认30s。
保留源标签
是否保留原始指标 Label,默认关闭。
4. 配置完成后,单击提交,完成后即可开始采集。
1. 在右侧的 K8s 自定义服务指标中单击通过 YAML 导入,进入配置流程。
2. 选择需要采集的集群。若所选集群未开启指标采集,请鼠标 hover 到红字处。根据指引开启指标采集后,即可选择集群。

3. 进入配置页面后配置指标采集。
支持四种 YAML 类型:
ServiceMonitor(Prometheus-Operator)
PodMonitor(Prometheus-Operator)
ScrapeConfig(Prometheus-Operator)
ScrapeConfig(Prometheus原生)
根据所选类型,在 YAML 输入框中输入相关配置即可。

4. 配置完成后,单击提交,完成后即可开始采集。

步骤3:检索分析

至此,您已完成 K8s 指标采集的配置。下一步,您可前往 检索分析页面,在控制台左侧选中目标指标主题,即可进行指标的检索和查询了。有关指标的检索语法规则可参见 指标检索语法规则