SuperAPI AI 工具集

cx-alerts

部署与运维

查看项目

更新于 10-15 20:28

技能介绍

用途:通过 cx alerts 系列命令管理 Coralogix 告警定义,覆盖列表、查看、创建、删除、启用、禁用,以及抑制规则和告警事件查询。

主要能力:cx alerts list(--name 过滤)、cx alerts get <id>、cx alerts create(--from-file,默认 stdin)、cx alerts delete/enable/disable <id>、cx alerts events(--alert-version-id、--start、--end)、cx alerts event-stats,以及 suppression-rules 的 list/get/create/update/delete。list、get、create 可加 -o json 或 -o toon 输出机器可读结果;-p <profile> 可重复以同时操作多个 profile。

告警类型:支持 12 种,包括日志即时/阈值/异常/比率阈值/新值/唯一计数/时间相对、指标阈值/异常、追踪即时/阈值,以及 Flow 序列告警。创建时需指定优先级 P1–P5,并应主动询问用户。

使用方式:创建时构造 alertDefProperties JSON,type 为字符串枚举,类型配置(如 logsThreshold)与 type 同级而非嵌套。可先用 cx alerts get <id> -o json 取模板修改后经 echo '<json>' | cx alerts create 或 --from-file 提交,再用 cx alerts list --name 验证。排查时可用 cx alerts list -o json | jq 过滤 ALERTING 状态。

限制与注意:cx alerts list 只输出一个指向告警总览页的链接,需按 <base>/alerts/<alert_id> 自行拼接单条告警链接;建议优先禁用而非删除以便审计。具体字段与枚举值需参考随附的 alert-schemas.md、dataprime-reference.md、logs-querying.md、promql-guidelines.md、spans-querying.md 等参考文件。