首页/云/可观测性速查/Webhook 接收器:payload 结构与中继要求
本包目录(282 条)
监控体系与方法40 条Prometheus 与采集64 条Grafana 与看板53 条日志平台52 条链路追踪23 条
告警与响应50 条

Webhook 接收器:payload 结构与中继要求

webhook_configs 把告警以 JSON POST 给自建中继(钉钉/飞书/企业微信群机器人网关);payload 含 groupKey、commonLabels 与 alerts 明细。

可观测性速查云更新于 2026-10-12

webhook payload 关键字段

webhook payload 关键字段
{
  "version": "4",
  "status": "firing",
  "receiver": "im",
  "groupKey": "{}/{severity=\"critical\"}:{alertname=\"HighErrorRate\"}",
  "commonLabels": { "alertname": "HighErrorRate", "service": "order-svc" },
  "commonAnnotations": { "summary": "错误率超过 5%" },
  "externalURL": "http://am.example.com:9093",
  "alerts": [
    { "status": "firing", "labels": { "instance": "10.0.1.5" },
      "annotations": { "summary": "当前值 12%" },
      "startsAt": "2026-10-12T10:07:00Z", "endsAt": "0001-01-01T00:00:00Z",
      "generatorURL": "http://prom.example.com/graph?g0.expr=...",
      "fingerprint": "a1b2c3d4e5f6a7b8" }
  ]
}
  • 中继要做幂等:同一 groupKey 重复投递不重复刷屏
  • 中继要做限速与失败退避,返回非 2xx 让 AM 记录投递失败
  • max_alerts 控制单次携带条数,超出部分按数量截断
resolved 事件同样走该 URL(send_resolved: true 时),中继需要区分状态渲染。

易错点

  • 中继只回 200 不校验下游结果,通道故障时无人知晓
  • 不设 max_alerts 且分组很大时,请求体超限被下游直接拒绝

数据来源与参考

  • Alertmanager 文档 · webhook_config
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌