用途:让智能体针对 Oodle 指标执行 PromQL 即时查询和范围查询,接口与 Prometheus 兼容。
主要能力:即时查询在单个时间点求值 PromQL,默认返回当前值,也可指定时间戳或相对时间;范围查询在时间区间内求值,--start、--end、--step 默认分别为 -1h、now、60s,时间参数支持 now、相对值(如 -1h、-7d)、RFC 3339 或 epoch 时间戳;支持 --partial-response 用于降级模式查询;输出可用 -o json 便于脚本处理。
使用方式:先安装并配置 CLI:brew install oodle-ai/oodle/oodle 与 oodle configure。确认端点可用:oodle metrics query --query "up" -o json | jq '.status'。查询前先发现指标与标签:oodle metrics names --start -1h --end now 和 oodle metrics labels <name> --start -1h --end now,再用已确认的名称与标签构建 PromQL。即时查询示例:oodle metrics query --query "sum(up)" -o json;指定时间:oodle metrics query --query "up" --time 1700000000 -o json。范围查询示例:oodle metrics query-range --query "rate(http_requests_total[5m])" --start -1h --end now --step 60s -o json。
适用场景:需要按 PromQL 读取 Oodle 指标做即时或区间分析、并希望先验证指标存在性的自动化流程。
限制与注意:不要运行未经验证的猜测查询,不存在的指标返回空结果而非报错;即时查询只读取 --time 前 5 分钟数据;步长过小会产生过多数据点,过大则丢失细节;401 需重新配置或设置 OODLE_API_KEY,400 检查 PromQL 语法,429 可加 --retries 3 并降低频率,连接被拒检查 OODLE_DEPLOYMENT 且勿带尾部斜杠;缺少 --query 会报错。其余细节暂未提供。