SuperAPI AI 工具集

oodle-monitors

部署与运维

查看项目

更新于 10-16 02:39

技能介绍

用途:该技能让智能体学会构建、校验和更新 Oodle 监控器,使告警可执行、范围明确且不抖动。监控器仅运行 PromQL,不能直接跑日志或 TraceQL 查询,需先由日志指标规则或追踪指标生成指标再告警。

主要能力:列出监控器、查看触发中的告警、按标签过滤、获取单个监控器、从文件创建/更新、删除。常用命令:oodle monitors list -o json、oodle monitors triggers -o json、oodle monitors get <id> -o json、oodle monitors create -f monitor.json、oodle monitors update <id> -f monitor.json、oodle monitors delete <id> --force。

使用方式:先安装配置(brew install oodle-ai/oodle/oodle;oodle configure,或设置 OODLE_API_KEY、OODLE_INSTANCE、OODLE_DEPLOYMENT),确认认证成功后再创建。执行前先确认资源 ID 是否在上下文中,否则先运行发现命令;结果不明确时向用户确认。更新遵循 get→编辑→update,避免只发送变更字段导致其他字段变 null。监控器 JSON 必填 name、promql_query、conditions(至少 critical、warn、no_data 之一);op 取值 0==、1!=、2>、3>=、4<、5<=;no_data 必须为 {"op": 0, "value": 1}。

适用场景:为生产环境指标设置阈值告警,按 team、env 等标签路由通知,并在 annotations 中提供 summary 与 runbook。

限制与最佳实践:使用 [5m] 或更长区间并设置 for,避免 [1m] 抖动;选择器必须带明确标签,不能留空;始终设置 keep_firing_for(无恢复阈值);每个监控器至少打 team 和 env 标签。常见错误包括 401(密钥无效)、404(ID 不存在)、connection refused(部署 URL 错误)、invalid promql query、missing conditions、429(批量创建限流,可加 --retries 3 并限速)。