如何为Prometheus指标添加EKS集群名称标签实现多集群指标过滤？

云原生阿岚

2026-7-11

解决方案

你添加的global.external_labels其实已经会自动给这个Prometheus实例采集到的所有指标带上clustername: ekscluster标签了，不需要额外做复杂配置，不过要确保配置正确生效，按下面步骤检查：

确认Terraform配置传递正确
如果你用helm_release资源部署kube-prometheus-stack，要保证全局标签通过values正确传入：

resource "helm_release" "kube_prometheus_stack" {
  name       = "kube-prometheus-stack"
  repository = "https://prometheus-community.github.io/helm-charts"
  chart      = "kube-prometheus-stack"
  version    = "你的chart版本号"

  set {
    name  = "prometheus.prometheusSpec.externalLabels.clustername"
    value = "ekscluster"
  }
}

要是用独立的values文件，那values.yaml里要对应写：

prometheus:
  prometheusSpec:
    externalLabels:
      clustername: ekscluster

验证标签是否生效
部署完成后，打开Prometheus UI，随便选个指标（比如node_cpu_seconds_total），查看它的标签列表，应该能看到clustername="ekscluster"；也可以直接用PromQL查询{clustername="ekscluster"}，能返回指标就说明配置生效了。
常见问题排查
- 进Prometheus Pod里检查配置文件：执行cat /etc/prometheus/config_out/prometheus.env.yaml，确认global.external_labels里有clustername: ekscluster
- 检查serviceMonitor或podMonitor的relabel配置，有没有不小心把这个全局标签去掉
- 要是配置改了没生效，手动重启Prometheus Pod试试（Terraform部署一般会自动触发，但偶尔可能需要手动操作）