SuperAPI AI 工具集

oodle-logs

数据与分析

查看项目

更新于 10-16 02:39

技能介绍

用途:通过 OpenSearch 兼容的查询 DSL 搜索日志数据,并发现可用的日志索引模式。

主要能力:列出日志索引模式;使用 NDJSON 格式的查询体搜索日志;支持 OpenSearch 聚合(aggs);支持时间范围过滤(--start/--end)。

使用方式:先安装并配置 CLI:brew install oodle-ai/oodle/oodle 和 oodle configure。查询前先运行 oodle logs index-patterns -o json 发现索引模式,再用 oodle logs query -f query.ndjson --start <start> --end <end> -o json 搜索。NDJSON 文件必须恰好两行:第一行选索引,第二行是查询。--start 默认 -1h,--end 默认 now;查询更早数据必须显式传 --start,否则静默返回 0 条。不要在查询体中对 timestamp 加 range 过滤,CLI 会自动注入。聚合时设 "size": 0,用 jq '.responses[0].aggregations' 读取。

限制:CLI 只支持单个搜索体(恰好两行 NDJSON),不支持多搜索对;不支持 regexp 查询、脚本和运行时字段,因此无法直接过滤或分组纯文本行内的值,可改用日志指标规则或客户端 jq 提取。

适用场景:日志检索、错误排查、按字段聚合统计、时间趋势分析。

失败处理:401 检查 API key;400 检查 NDJSON 与 DSL;空结果放宽时间范围或确认索引名;429 加 --retries 3。