EKS集群中Alertmanager邮件通知配置报错求助

版本兼容性排查 #

首先确认你安装的kube-prometheus-stack Helm chart版本对应的AlertmanagerConfig CRD版本：

• 执行 helm list -n monitoring 查看当前chart版本
• 不同chart版本对应不同CRD版本：
  • 版本>=45.x的chart支持 monitoring.coreos.com/v1beta1
  • 旧版本（<45.x）仅支持 v1alpha1
    如果你的chart版本不支持v1beta1，即使CRD存在也会报错，需匹配对应apiVersion。

配置文件语法修正 #

你的配置存在几处语法错误，直接导致部署失败：

1. route.receivers类型错误：
   receivers字段要求是数组，不能写字符串，修改为：

   receivers: ['email']
   

2. 子路由未指定接收器：
   两个子路由没有配置receiver，告警无法正确转发，补充后：

   routes:
   - matchers:
     - name: alertname
       value: CPUisBurning
     receiver: 'email'
   - matchers:
     - name: alertname
       value: AppPodRestart
     repeatInterval: 5m
     receiver: 'email'
   

3. v1alpha1版本适配（若需降级）：
   如果只能用v1alpha1，matchers要换成match字段：

   routes:
   - match:
       alertname: CPUisBurning
     receiver: 'email'
   - match:
       alertname: AppPodRestart
     repeatInterval: 5m
     receiver: 'email'
   

CRD有效性验证 #

执行命令确认CRD版本是否匹配：

kubectl get crd alertmanagerconfigs.monitoring.coreos.com

查看输出的VERSION字段，确保配置文件的apiVersion和它一致。

Secret合法性检查 #

确认monitoring命名空间下存在mail-pass Secret，且包含pass键：

kubectl get secret mail-pass -n monitoring

若不存在，用以下命令创建（Gmail需使用应用专用密码）：

kubectl create secret generic mail-pass -n monitoring --from-literal=pass=你的邮箱授权密码

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