SuperAPI AI 工具集

openobserve-api

编程与开发

查看项目

更新于 10-15 21:41

技能介绍

用途:让 AI 智能体以 curl 调用 OpenObserve REST API,完成查询、仪表盘与面板管理、流管理、告警与数据写入,适用于云或自托管实例,无需 CLI。

主要能力:搜索查询 POST $BASE/_search(?type=logs|metrics|traces),SQL 为 DataFusion/Arrow 风格,标识符用双引号、字符串用单引号,支持 histogram 时间分桶、match_all/str_match 全文检索;指标可用 PromQL 的 /prometheus/api/v1/query_range;追踪可用 GET $BASE/{stream}/_around。流管理支持列表、schema、设置与删除。仪表盘支持增删改查、面板增删改、文件夹移动。还支持文件夹、告警、模板与目标,以及 JSON、_multi、_bulk、OTLP、Loki、Prometheus remote-write 写入。

用法要点:认证为 HTTPS Basic Auth,无 token 端点,可用 curl -u "email:PASSWORD" 或显式 Authorization: Basic。时间戳为微秒,必须设置 start_time/end_time,否则全量扫描。分页用 from 与 size(单次上限约 10000)。仪表盘 PUT/POST 请求体必须是未包裹的 v8 内层对象,更新需带当前 hash,409 表示 hash 过期需重新获取。面板 JSON 位于 dashboard.tabs[].panels[],布局网格为 96 列。

限制与注意:自定义 SQL 已聚合时,fields.y 的 aggregationFunction 必须为 null,否则会二次聚合导致数值虚高;Table 面板建议只放一个 y 项;Metric 面板需显式映射结果列;ROUND 加通配时间戳可能触发 GROUP BY 报错,可改用 decimals 或 CAST;每次 PUT 都会改变 hash,需先 GET 再 PUT。文档与源码冲突时以服务端源码为准。SDK 有 Python、Go、Helm、OTel collector,但多数任务直接用 curl 更合适。具体收费与平台细节暂未提供。