SuperAPI AI 工具集

oodle-log-metrics

通用与其它

查看项目

更新于 10-16 02:39

技能介绍

用途:将日志流转换为指标,用于计数或对日志行中的数值做告警。监控基于规则产出的指标运行,而非直接查询日志。

主要能力:通过 oodle log-metrics 命令创建、查看、更新、删除日志指标规则。规则包含 name、filter(条件,支持 all/any/not 嵌套,操作符 is、contains、matches regex、exists,无 !=,用 not 代替)、labels(静态值或 valueExtractor 的 field/jsonPath/regex)与 metricDefinitions(至少一个,类型为 log_count、counter、gauge、histogram)。产出指标名为 oodle_logs_<name>,histogram 会产出 _bucket、_sum、_count。

使用方式:先安装并配置(brew install oodle-ai/oodle/oodle;oodle configure),用 oodle log-metrics list -o json 确认端点可用。创建前先用 oodle logs query 或日志浏览器验证过滤条件确实匹配日志,并估算标签基数,再执行 oodle log-metrics create -f rule.json。更新前必须先 get 保存现有规则,因为 update 会整体替换文档。删除用 oodle log-metrics delete <id> --force。

适用场景:对日志行计数、对行内数值(如耗时)做直方图、按用户等标签对罕见事件告警。

限制:规则只对创建之后到达的日志生效,不回填历史数据;标签应保持 2–3 个低基数字段,避免 request_id、user_id、trace_id 等高基数标签;正则使用 Rust 语法,捕获组 1 为取值,JSON 中需转义反斜杠;正则不匹配时标签为空、数值为 0;log_count 不能带 field、jsonPath 或 regex。常见错误包括 401、404、400 参数校验失败与 429 限流(可加 --retries 3 并限速)。