Kubernetes HPA关联外部指标失败：metricLabels为空求助

你的问题核心在于Prometheus Adapter的查询规则没有保留需要的标签，导致同步到K8s Metrics API时metricLabels为空。以下是具体修复方案：

1. 修正metricsQuery的聚合逻辑 #

你当前的metricsQuery使用sum(<<.Series>>{<<.LabelMatchers>>}) by (name)，这里的by (name)会丢弃hostname、localnode、path等其他标签（且你的指标里可能根本不存在name标签），直接导致metricLabels为空。

需要将聚合维度修改为你需要保留的标签：

- seriesQuery: '{__name__="batchCommandsActive_totalCount",hostname!="",localnode!="",path!=""}'
  metricsQuery: sum(<<.Series>>{<<.LabelMatchers>>}) by (hostname, localnode, path)
  resources:
    namespaced: false
  labels:
    hostname: "hostname"
    localnode: "localnode"
    path: "path"

2. 添加labels字段明确标签映射 #

通过labels字段指定Prometheus标签与K8s外部指标标签的一一映射，强制Adapter将这些标签同步到Metrics API的metricLabels结构中。

3. 验证配置生效 #

修改ConfigMap后，重启Prometheus Adapter Pod使配置生效：

kubectl rollout restart deployment <prometheus-adapter-deployment-name> -n <namespace>

重新查询Metrics API验证结果：

kubectl get --raw "/apis/external.metrics.k8s.io/v1beta1/namespaces/<namespace>/batchCommandsActive_totalCount/"

此时返回结果的metricLabels应包含hostname、localnode、path三个标签及其对应值。

额外注意事项 #

• 如果需要让HPA关联到对应Pod，需确保hostname/localnode标签能匹配Pod的节点标签（如kubernetes.io/hostname），保证指标与Pod的关联逻辑有效。
• 若聚合后仍无标签，先检查Prometheus原始指标是否确实包含hostname、localnode、path标签，避免seriesQuery过滤掉了有效数据。

内容的提问来源于stack exchange，提问作者Agilulfe