SuperAPI AI 工具集

oncall-triage

部署与运维

查看项目

更新于 10-16 05:49

技能介绍

用途:通过 gcx CLI 对 Grafana OnCall 告警组进行分流处理,即对已路由聚合的告警投递做查看、检查、确认、静默与解决。它处理"当前什么在呼叫",而规则侧根因分析由 gcx alert rules 或 investigate-alert 负责。核心原则是只使用 gcx,不直接调用 OnCall API(不用 curl 或 HTTP 库)。

主要能力:列出活跃告警组,默认过滤 state 为 firing/acknowledged/silenced 且 is_root=true,与 OnCall UI 一致;支持按 --state、--team、--integration、--escalation-chain、--mine、--max-age 等缩小范围,团队/集成/链需用 ID。可获取单个告警组详情,一次请求即填充 status.links.* 丰富信息,包括规则、仪表盘、SLO、Alertmanager 指纹等。需要逐条告警细节时用 list-alerts,默认按标签集折叠,--history 展开每次投递。可将告警链接到告警规则、仪表盘或 SLO 做进一步排查。动作动词包括 acknowledge、unacknowledge、silence(带 --duration 秒)、unsilence、resolve、unresolve、delete,均为幂等(delete 除外),可单目标传 ID,也可按过滤器批量执行。

必要用法:需先配置 gcx 并有启用 OnCall 的活跃上下文,否则先用 setup-gcx。常用命令如 gcx irm oncall alert-groups list、get <id>、acknowledge <id>、silence <id> --duration 3600;批量如 acknowledge --team <PK> --state firing --force。

限制:默认列表不含已解决和子组,历史需显式加 --all 等;无标题子串过滤,需用 JSON+jq 再循环 ID;代理模式下匹配数大于 1 时批量动作必须 --force,且不得预先填充,须用户确认;无 ID 也无过滤器的批量调用会被阻止。webhook 类集成下 links 可能不完整、subject.labels 为空属正常。gcx irm oncall alerts 和 alerts get 已移除,改用 list-alerts。