amtool

Alertmanager 告警与静默管理

补充说明

amtool 查询告警、创建和管理静默，校验 Alertmanager 配置。它通过 HTTP API 操作运行中的 Alertmanager。

常用示例

amtool --alertmanager.url=http://alertmanager:9093 alert query
amtool alert query --alertmanager.url=http://alertmanager:9093
amtool alert add alertname=InstanceDown job=api severity=critical
amtool silence add alertname=InstanceDown --duration=2h --comment='维护窗口'
amtool silence query
amtool silence expire <silence-id>
amtool check-config alertmanager.yml

易错点与排错

• 默认连接 localhost:9093；远程实例要显式 --alertmanager.url。
• 标签匹配是精确/正则的组合，写错会导致静默不生效或误静默。
• --duration 支持 30m、2h、1d 等格式；不要写裸数字。
• 静默创建后要 query 确认 ID 和匹配范围，避免漏告警。
• 集群模式下 API 可能转发到任意节点；确认所有节点配置一致。
• check-config 只校验配置语法，不验证通知渠道是否可达。
• 告警抑制（inhibit）和静默是两套机制，排查时都要看。

相关命令

• promtool — Prometheus 规则校验
• alertmanager — 服务端
• logcli — 日志查询