Alertmanager集成Webex报错：webex_configs字段未找到，求解决示例

错误根源 #

你遇到的field webex_configs not found错误，核心原因是当前使用的Prometheus Operator版本对应的CRD（自定义资源定义）中，尚未添加webex_configs字段。虽然Alertmanager核心版本0.24+已原生支持该配置项，但Prometheus Operator需要同步更新CRD才能识别这个字段。

解决路径 #

路径1：升级Prometheus Operator至支持版本 #

1. 检查当前Operator版本：
   执行命令查看镜像版本：

   kubectl get deployment prometheus-operator -n monitoring -o jsonpath='{.spec.template.spec.containers[0].image}'
   

   一般v0.59+版本的Operator开始支持webex_configs（具体以对应版本的Release Notes为准）。
2. 升级Operator：
   可通过官方Helm Chart升级，或直接替换Deployment的镜像版本。升级完成后，CRD会自动更新，此时即可正常使用webex_configs字段。

路径2：用webhook_configs替代（无需升级） #

如果暂时无法升级Operator，可通过手动构造webhook请求模拟webex_configs的功能——本质上webex_configs就是封装了向Webex API发送POST请求的逻辑。

配置步骤

1. 创建Webex入站Webhook：
   进入目标Webex频道，点击右上角三点→「集成」→「创建入站webhook」，填写名称、目标URL（格式为https://webexapis.com/v1/webhooks/incoming/<你的webhook-token>），选择对应频道后保存，获取完整的webhook URL。

2. Alertmanager配置示例（Operator CRD）：

   apiVersion: monitoring.coreos.com/v1alpha1
   kind: AlertmanagerConfig
   metadata:
     name: webex-alerts
     namespace: monitoring
   spec:
     receivers:
     - name: 'webex-receiver'
       webhookConfigs:
       - url: 'https://webexapis.com/v1/webhooks/incoming/<你的webhook-token>'
         sendResolved: true
         httpConfig:
           headers:
             Content-Type: application/json
         body: |
           {
             "text": "**Alertmanager告警**\n\n状态: {{ .Status | toUpper }}\n告警名称: {{ .Labels.alertname }}\n级别: {{ .Labels.severity }}\n摘要: {{ .Annotations.summary }}\n描述: {{ .Annotations.description }}\n触发时间: {{ .StartsAt }}"
           }
     route:
       groupBy: ['alertname']
       groupWait: 30s
       groupInterval: 5m
       repeatInterval: 1h
       receiver: 'webex-receiver'
   

3. Alertmanager原生配置文件示例：

   global:
     resolve_timeout: 5m
   route:
     group_by: ['alertname']
     group_wait: 30s
     group_interval: 5m
     repeat_interval: 1h
     receiver: 'webex-receiver'
   receivers:
   - name: 'webex-receiver'
     webhook_configs:
     - url: 'https://webexapis.com/v1/webhooks/incoming/<你的webhook-token>'
       send_resolved: true
       http_config:
         headers:
           Content-Type: application/json
       body: |
         {
           "text": "**Alertmanager告警**\n\n状态: {{ .Status | toUpper }}\n告警名称: {{ .Labels.alertname }}\n级别: {{ .Labels.severity }}\n摘要: {{ .Annotations.summary }}\n描述: {{ .Annotations.description }}\n触发时间: {{ .StartsAt }}"
         }
   

路径1的webex_configs配置示例（升级Operator后） #

升级完成后，可直接使用原生webex_configs，示例如下（需提前创建Webex Bot并获取token、目标频道roomId）：

apiVersion: monitoring.coreos.com/v1alpha1
kind: AlertmanagerConfig
metadata:
  name: webex-alerts
  namespace: monitoring
spec:
  receivers:
  - name: 'webex-receiver'
    webexConfigs:
    - apiUrl: 'https://webexapis.com/v1/messages'
      token: '<你的Webex Bot Token>'
      roomId: '<目标频道RoomId>'
      sendResolved: true
      message: |
        **Alertmanager告警**
        状态: {{ .Status | toUpper }}
        告警名称: {{ .Labels.alertname }}
        级别: {{ .Labels.severity }}
        摘要: {{ .Annotations.summary }}
        描述: {{ .Annotations.description }}
        触发时间: {{ .StartsAt }}
  route:
    groupBy: ['alertname']
    groupWait: 30s
    groupInterval: 5m
    repeatInterval: 1h
    receiver: 'webex-receiver'

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