HPA未按metricSelector过滤外部指标问题求助

问题根源 #

你的HPA无法按queue和scm_instance标签过滤外部指标，核心原因有两个：

1. Prometheus Adapter未暴露可过滤的标签维度：原配置仅将namespace作为资源维度，queue和scm_instance标签未被注册为K8s API可识别的外部指标过滤维度，导致HPA的metricSelector无法匹配目标标签，只能默认取所有指标的总和。
2. HPA v1的alpha注解兼容性问题：K8s 1.27中autoscaling.alpha.kubernetes.io/metrics注解属于废弃的alpha特性，稳定性不足，推荐使用标准的autoscaling/v2 API配置指标。

修复步骤 #

1. 修改Prometheus Adapter配置 #

更新Adapter配置，将queue和scm_instance加入资源维度映射，并确保指标查询按这两个标签+namespace分组：

external:
    - seriesQuery: '{__name__=~"rq_jobs", namespace="scanners", scm_instance!="", status="queued"}'
      resources:
        overrides:
          namespace:
            resource: namespace
          queue:
            resource: "queue"
          scm_instance:
            resource: "scm_instance"
      name:
        matches: ^(.*)
        as: "hpa_rq_jobs"
      metricsQuery: sum(rq_jobs{status='queued', scm_instance!=""}) by (namespace, scm_instance, queue)

修改后重启Prometheus Adapter Pod，让配置生效。

2. 替换HPA为autoscaling/v2版本 #

废弃v1的alpha注解，改用标准的autoscaling/v2 API配置外部指标过滤：

apiVersion: autoscaling/v2
kind: HorizontalPodAutoscaler
metadata:
  name: hpa-semgrep
  namespace: scanners
spec:
  maxReplicas: 20
  minReplicas: 2
  scaleTargetRef:
    apiVersion: apps/v1
    kind: Deployment
    name: deploy-scanner-semgrep
  metrics:
  - type: External
    external:
      metric:
        name: hpa_rq_jobs
        selector:
          matchLabels:
            queue: "semgrep"
            scm_instance: "rq-exporter-bitbucket"
      target:
        type: AverageValue
        averageValue: 30

验证操作 #

1. 检查外部指标是否正确暴露：

kubectl get --raw "/apis/custom.metrics.k8s.io/v1beta1/namespaces/scanners/external/hpa_rq_jobs" | jq .

确认返回结果中存在queue: "semgrep"且value: "0"的指标条目。

2. 查看HPA状态：

kubectl get hpa hpa-semgrep -n scanners -w

观察HPA是否正确获取到目标指标值，Pod数量维持在minReplicas=2。

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