GKE中HPA无法读取内存指标问题求助

核心配置检查项 #

• Deployment资源请求配置确认
  必须确保Deployment下的每个容器都明确配置resources.requests.memory，格式要规范（例如512Mi、1Gi），示例配置：

  containers:
  - name: app-container
    image: your-app-image
    resources:
      requests:
        cpu: "100m"
        memory: "512Mi" # HPA计算内存使用率依赖该配置，缺失则无法采集指标
      limits:
        cpu: "500m"
        memory: "1Gi"
  

  注意：仅配置limits而无requests的话，metrics-server不会采集该Pod的内存指标，HPA自然无法识别。

• Metrics Server状态验证
  执行以下命令确认metrics-server运行正常：

  kubectl get pods -n kube-system | grep metrics-server
  kubectl logs -n kube-system <metrics-server-pod-name>
  

  检查日志中是否存在内存指标采集失败的报错（如权限不足、采集超时）。GKE 1.24默认自带的metrics-server通常正常，但自定义配置时需确保启用了内存指标采集。

• HPA版本与指标配置匹配
  对于autoscaling/v2版本，HPA的内存指标需明确按Resource类型配置，示例：

  apiVersion: autoscaling/v2
  kind: HorizontalPodAutoscaler
  metadata:
    name: app-hpa
  spec:
    scaleTargetRef:
      apiVersion: apps/v1
      kind: Deployment
      name: app-deployment
    minReplicas: 1
    maxReplicas: 5
    metrics:
    - type: Resource
      resource:
        name: cpu
        target:
          type: Utilization
          averageUtilization: 70
    - type: Resource
      resource:
        name: memory
        target:
          type: Utilization
          averageUtilization: 80 # 需与Deployment的内存request对应，拼写不能出错
  

  若使用autoscaling/v2beta2，配置结构类似，但需确保无语法错误（GKE 1.24原生支持该版本）。

• Pod内存指标可见性验证
  执行命令检查Pod是否能被采集到内存数据：

  kubectl top pods
  

  若某个Pod无内存输出，说明该Pod的内存request未配置或metrics-server采集失败，HPA无法识别这类Pod的内存指标。

• GKE集群监控组件状态
  确认Cloud Monitoring（原Stackdriver）与集群关联正常，虽然HPA依赖metrics-server，但集群监控组件异常可能间接影响指标传递。可在GKE控制台的「监控」页面查看Pod内存指标是否正常展示。

常见遗漏点 #

• Deployment多容器场景下，仅给部分容器配置了内存request，遗漏的容器会导致HPA无法计算整体内存使用率。
• HPA配置中内存指标的resource.name拼写错误（如写成mem而非memory），或target.averageUtilization设置逻辑不合理。
• Metrics-server自身资源不足，导致无法正常采集内存指标，可检查其Deployment的资源请求与限制配置。

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