容器服务
容器服务
容器服务
文档指南
请输入
容器服务 VKE
产品动态
Kubernetes 版本发布记录
组件发布记录
监控组件
DNS 组件
GPU 组件
Sandbox 组件
安全公告
产品公告
历史公告
用户指南
集群
节点池
授权
网络
容器网络
服务（Service）
路由（Ingress）
APIG Ingress
ALB Ingress
自定义转发规则配置示例
CLB Ingress
Nginx Ingress
Gateway API
工作负载
存储
数据管理中心（DMC）
对象存储（TOS）
FSX 访问方式
文件存储（NAS）
FSX 访问方式
弹性文件存储（EFS）
文件存储（vePFS）
FSX 访问方式
vePFS Client 访问方式
NFS 访问方式
大数据文件存储（CloudFS）
弹性伸缩
工作负载弹性伸缩
事件驱动伸缩（KEDA）
组件管理
网络组件
监控组件
DNS 组件
GPU 组件
Sandbox 组件
异构计算
调度管理
可观测性
基础观测
诊断与巡检
最佳实践
网络
可观测性
安全合规
API 参考
集群管理
节点池管理
组件管理
机型镜像管理
云原生观测
巡检诊断
弹性容器实例
附录
开发指南
常见问题
通用 FAQ
集群 FAQ
集群管理
集群升级
节点与节点池 FAQ
授权 FAQ
工作负载 FAQ
服务与路由 FAQ
存储 FAQ
弹性伸缩 FAQ
可观测性 FAQ
配额 FAQ
组件 FAQ
容器镜像 FAQ
AI 云原生
推理套件
Helm 模板 AI 应用
Deepseek 实践
Qwen 实践
最佳实践
MiniMax 模型部署
Qwen 模型部署
弹性容器实例 VCI
最新动态
用户指南
虚拟节点
VKE 集群使用虚拟节点
自建/跨云集群使用虚拟节点
创建 VCI 实例
VCI Agent Sandbox
安全合规
- 文档首页
容器服务容器服务 VKE用户指南可观测性基础观测集群观测使用自建 Prometheus 采集控制面组件指标
复制全文
下载 pdf使用自建 Prometheus 采集控制面组件指标
文档反馈
问问助手容器服务集群对外透出了控制面组件的监控指标，允许您使用自建 Prometheus 采集并搭建集群控制面监控大盘，实现与自建监控系统的集成。本文介绍如何开启集群的控制面组件指标采集。
使用限制
- 集群 Kubernetes 版本要求如下。如集群版本过低，请先升级版本。详情请参见 升级集群。
- Kubernetes v1.24 版本：v1.24.17-vke.44 及以上版本。
- Kubernetes v1.26 版本：v1.26.15-vke.34 及以上版本。
- Kubernetes v1.28 版本：v1.28.15-vke.27 及以上版本。
- Kubernetes v1.30 版本：v1.30.4-vke.12 及以上版本。
- Kubernetes v1.32 版本：v1.32.3-vke.7 及以上版本。
- 容器服务发布的其余更高 Kubernetes 版本。
- 当前仅支持采集集群控制面中 kube-apiserver、etcd、kube-scheduler、kube-controller-manager 和 cloud-controller-manager 托管组件的指标，暂不支持采集其他托管组件的指标。相关组件指标，请参见 容器服务指标。
前提条件
- 自建 Prometheus 支持部署在待监控的集群内，也可以部署在集群外。
- 当自建 Prometheus 部署在待监控集群外部时，请保证其能够访问容器服务集群的 API Server，并且拥有/metrics的读权限。
操作步骤
步骤一：开启控制面指标采集
- 登录 容器服务控制台。
- 在顶部导航栏，选择您业务所在地域。
- 在左侧导航栏单击 集群，单击目标集群名称，进入集群管理控制台。
- 在左侧导航栏中，选择 运维配置，并在 自定义指标采集 配置中，开启 管控面组件指标采集。
-
步骤二：配置采集规则
使用自建 Prometheus 采集集群控制面组件指标前，需要在 Prometheus 的配置文件prometheus.yaml中，配置控制面组件的指标采集 Job。示例代码如下：
global:
scrape_interval: 15s # By default, scrape targets every 15 seconds.
# Attach these labels to any time series or alerts when communicating with
# external systems (federation, remote storage, Alertmanager).
external_labels:
monitor: 'custom-prometheus-monitor'
# A scrape configuration containing exactly one endpoint to scrape:
# Here it's Prometheus itself.
scrape_configs:
# The job name is added as a label `job=<job_name>` to any timeseries scraped from this config.
- job_name: api-server-demo
......
- job_name: etcd-demo
......
- job_name: scheduler-demo
......
集群内部监控
如果您的自建 Prometheus 部署在待监控集群内部，您可以参考如下采集规则代码示例，完成控制面组件的数据采集。
APIServer
ETCD
Kube-Scheduler
Kube-Controller-Manager
Cloud-Controller-Manager
采集规则代码示例，如下所示：
- job_name: api-server-demo
params:
job: ["apiserver"]
kubernetes_sd_configs:
- role: endpoints
relabel_configs:
- action: keep
regex: default;kubernetes;https
source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
scheme: https
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
tls_config:
ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
insecure_skip_verify: false
采集规则代码示例，如下所示：
- job_name: etcd-demo
params:
job: ["etcd"]
kubernetes_sd_configs:
- role: endpoints
relabel_configs:
- action: keep
regex: default;kubernetes;https
source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
scheme: https
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
tls_config:
ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
insecure_skip_verify: false
采集规则代码示例，如下所示：
- job_name: kube-scheduler-demo
params:
job: ["scheduler"]
kubernetes_sd_configs:
- role: endpoints
relabel_configs:
- action: keep
regex: default;kubernetes;https
source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
scheme: https
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
tls_config:
ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
insecure_skip_verify: false
采集规则代码示例，如下所示：
- job_name: kcm-demo
params:
job: ["kcm"]
kubernetes_sd_configs:
- role: endpoints
relabel_configs:
- action: keep
regex: default;kubernetes;https
source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
scheme: https
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
tls_config:
ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
insecure_skip_verify: false
采集规则代码示例，如下所示：
- job_name: ccm-demo
params:
job: ["ccm"]
kubernetes_sd_configs:
- role: endpoints
relabel_configs:
- action: keep
regex: default;kubernetes;https
source_labels:
- __meta_kubernetes_namespace
- __meta_kubernetes_service_name
- __meta_kubernetes_endpoint_port_name
scheme: https
bearer_token_file: /var/run/secrets/kubernetes.io/serviceaccount/token
tls_config:
ca_file: /var/run/secrets/kubernetes.io/serviceaccount/ca.crt
insecure_skip_verify: false
集群外部监控
如果自建 Prometheus 部署在待监控集群外部，则无法像在集群内那样自动挂载 ServiceAccount 凭证和访问 Kubernetes 内部服务。配置方法如下：
- 手动指定容器服务集群的 APIServer 地址，允许外部 Prometheus 能够正确连接集群。
- 手动提供认证凭证（CA 证书 + Bearer Token），通过 Kubernetes API 的权限校验。
- 基于 Node 进行服务发现，自动获取集群所有 Node 节点的地址，后续采集相关监控指标。
配置示例代码如下：
- job_name: 'external-cluster-monitor-job'
scheme: https
tls_config:
ca_file: /etc/prometheus/kubernetes-ca.crt
bearer_token: '<ServiceAccount bearer_token>'
kubernetes_sd_configs:
- api_server: 'https://<APIServer URL>'
role: node
tls_config:
ca_file: /etc/prometheus/kubernetes-ca.crt
bearer_token: '<ServiceAccount bearer_token>'
结果验证
- 登录自建 Prometheus 控制台，切换到 Graph 页面。
- 输入up命令，查看指定的采集任务是否正常。
- 预期结果如下，以 APIServer 观测任务为例，up{instance="xxx.xxx.xxx.xxx:6443", job="api-server-demo"}表示对应采集任务，其值为1时，表示该任务工作正常。
-
- 输入以下指标，查看是否可以正常显示。
- apiserver_request_total{job="api-server-demo"}
- 预期结果如下，如果能正常查询到指标和数据，表明自建 Prometheus 可以正常采集到集群核心组件的监控指标。
-
最近更新时间：2026.04.30 15:29:20
这个页面对您有帮助吗？
有用
有用
无用
无用