SuperAPI AI 工具集

kibana-alerting-rules

通用与其它

查看项目

更新于 10-15 21:37

技能介绍

用途:创建、查看、更新和管理 Kibana 告警规则,包括选择规则类型、编码阈值与分组语义、按需附加动作,以及在用户仅需发现现有覆盖时只读列出或过滤规则。

主要能力:规则由条件(params + rule_type_id)、调度(检查频率)和动作(可选连接器)三部分组成。支持按标签、文本过滤和分页查询规则;支持创建阈值规则(如 .index-threshold、.es-query、metrics.alert.threshold);支持更新规则(rule_type_id 和 consumer 不可变);支持启用、禁用、全部静音、单条告警静音、定时暂停和删除等生命周期操作。

使用方式:通过 elastic CLI 执行操作,不直接调用 HTTP API。若未安装 elastic CLI,需告知用户其用途,不要猜测凭据或尝试其他变通方法。创建规则时需提供 name、rule_type_id、consumer、schedule、params 等必填字段。非默认 Kibana Space 需在路径前加 kbn:/s/<space_id>/api/alerting/。

适用场景:指标阈值告警、文档计数或 Query DSL 条件告警、Observability 指标告警,以及规则的日常运维管理。

限制:不适用于 Security 检测规则(consumer 为 securitySolution/siem 应使用专用 Security Detections API)。rule_type_id 和 consumer 创建后不可更改,需删除重建。规则动作不能引用不同 Space 的连接器。建议最小检查间隔为 1m,昂贵规则在服务器运行超时(默认 5m)后会被取消。自托管环境需在 kibana.yml 中配置稳定的 xpack.encryptedSavedObjects.encryptionKey。规则级 notify_when 和 throttle 已弃用,频率应设置在动作对象内。导入/导出会禁用规则并剥离连接器密钥。