Azure AKS中控制平面指标采集问题的排查与解决

侯媛琴

于 2025-06-13 09:00:56 发布

阅读量340

点赞数 5

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_07081/article/details/148624266

Azure AKS中控制平面指标采集问题的排查与解决

AKS Azure Kubernetes Service 项目地址: https://gitcode.com/gh_mirrors/ak/AKS

问题背景

在Azure Kubernetes Service(AKS)环境中，用户经常需要监控集群控制平面的各项指标，特别是集群自动扩展器(Cluster Autoscaler)的指标。这些指标对于理解集群的自动扩展行为和性能调优至关重要。

问题现象

用户在使用Azure托管的Prometheus(Managed Prometheus)服务时，发现通过配置ama-metrics-settings-configmapConfigMap后，预期的控制平面指标(包括集群自动扩展器指标)并未被正确采集。具体表现为：

虽然Prometheus Collector Pods成功重启，表明配置已生效
但在Azure门户中看不到新增的控制平面指标
通过端口转发访问Prometheus端点时，未发现预期的服务发现目标

根本原因分析

经过深入排查，发现问题的根源在于：

预览功能未启用：控制平面指标采集是AKS的一项预览功能，需要显式启用后才能正常工作
架构理解偏差：控制平面指标的采集路径与常规工作负载指标不同，不通过数据平面的Prometheus Collector Pods

解决方案

要正确启用AKS控制平面指标采集，需要执行以下步骤：

1. 注册预览功能标志

首先需要注册AzureMonitorMetricsControlPlanePreview功能标志：

az feature register --namespace "Microsoft.ContainerService" --name "AzureMonitorMetricsControlPlanePreview"

等待注册状态显示为"Registered"后继续后续操作。

2. 更新AKS集群配置

注册完成后，需要更新AKS集群配置以应用变更：

az aks update -g <资源组名称> -n <集群名称>

3. 配置指标采集

创建或更新ama-metrics-settings-configmapConfigMap，确保启用了所需的控制平面指标采集：

apiVersion: v1
kind: ConfigMap
metadata:
  name: ama-metrics-settings-configmap
  namespace: kube-system
data:
  default-scrape-settings-enabled: |-
    controlplane-apiserver = true
    controlplane-cluster-autoscaler = true
    controlplane-kube-scheduler = true
    controlplane-kube-controller-manager = true
    controlplane-etcd = true