SuperAPI AI 工具集

oodle-metrics

数据与分析

查看项目

更新于 10-16 02:39

技能介绍

用途:该技能教智能体查找指标名称、枚举标签与标签值,并据此构建能一次返回数据的 PromQL 查询。

前置条件:brew install oodle-ai/oodle/oodle;oodle configure。可用 oodle metrics names -o json | jq 'length' 确认指标端点可用。

主要能力与用法:执行任何 oodle 命令前,先确认所需指标名是否已在上下文中;否则用 oodle metrics names -o json | jq -r '.[] | select(startswith("<prefix>"))' 发现,再用 oodle metrics labels <name> 枚举标签,用 oodle metrics label-values <name> <label> 枚举取值,最后仅用已确认的标签和值构建 PromQL。names、labels、label-values 只读取时间范围内有样本的序列,默认范围为最近一小时;稀疏指标(日志指标、错误计数器)应先用 --start -7d 等放宽范围再判断是否存在。

最佳实践:列出指标时始终按前缀过滤;写 PromQL 前先跑三步发现流程;脚本中始终用 jq 解析 JSON,不要解析表格输出;计数器速率用 rate(...[5m]) 而非 [1m];按标签分组前先确认基数有界。

失败处理:401 检查 API key 或 OODLE_API_KEY;标签为空时确认指标名或放宽时间范围;connection refused 检查 OODLE_DEPLOYMENT;查询为空多为标签名或值错误;超时多为基数过高;parse error 先在 UI 验证语法;429 可加 --retries 3 并缓存 label-values 输出。

限制:资料未提供更多平台、收费或效果信息。