首页/云/可观测性速查/Alertmanager API v2:查询告警与自动化静默
本包目录(282 条)
监控体系与方法40 条Prometheus 与采集64 条Grafana 与看板53 条日志平台52 条链路追踪23 条
告警与响应50 条

Alertmanager API v2:查询告警与自动化静默

/api/v2/alerts 支持 filter 查询,/api/v2/silences 以 JSON 创建静默,配合发布流水线实现自动化静默;接口无鉴权时只监听内网。

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

API 调用示例

API 调用示例
# 查询指定告警(filter 为 PromQL 风格标签过滤)
curl -s 'http://127.0.0.1:9093/api/v2/alerts?filter=alertname%3DHighErrorRate&active=true&silenced=false'

# 创建静默
curl -s -XPOST http://127.0.0.1:9093/api/v2/silences -H 'Content-Type: application/json' -d '{
  "matchers": [{"name": "service", "value": "order-svc", "isRegex": false}],
  "startsAt": "2026-10-12T09:00:00Z",
  "endsAt": "2026-10-12T11:00:00Z",
  "createdBy": "deploy-bot",
  "comment": "order-svc 发布窗口"
}'

# 撤销静默
curl -s -XDELETE http://127.0.0.1:9093/api/v2/silence/<silence-id>
创建接口返回 silenceID,流水线记录它即可在发布结束后精确撤销。

易错点

  • 时间字段是 RFC3339 且带时区,写本地时间不加偏移会整体错位
  • 接口暴露到公网会被任意创建静默,仅监听内网或前置带鉴权的代理

数据来源与参考

  • Alertmanager 文档 · API v2
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌