SuperAPI AI 工具集

victorialogs-query

通用与其它

查看项目

更新于 10-15 21:06

技能介绍

用途:通过 curl 直接调用 VictoriaLogs 的 HTTP API,用 LogsQL 搜索日志、执行统计查询、发现字段与日志流、分析日志命中量(hits)和分面(facets),用于日志排障与结构探索。

环境变量:$VM_LOGS_URL 为基础地址;$VM_CURL_CONFIG 指向含认证头的 curl 配置文件(远程设置,本地可留空,默认 /dev/null 即无认证)。命令通过 --config "${VM_CURL_CONFIG:-/dev/null}" 加载认证。

主要端点:/select/logsql/query(日志查询,返回 JSON Lines 逐行对象);stats_query(即时统计,用 time,查询须含 | stats 管道);stats_query_range(区间统计,用 start/end/step);hits(日志量,step 必填);facets(一次性返回所有字段分布,最佳发现工具);以及 field_names、field_values、stream_field_names、stream_field_values、streams、stream_ids 等发现端点。

必要用法与规则:所有端点建议始终传 start,否则会扫描全部数据;时间用 RFC3339 格式,不支持 Unix 时间戳;含特殊字符的查询需 URL 编码(POST 用 --data-urlencode);日志查询返回 JSON Lines 而非数组,可用 jq -s 收集。

限制与该注意:LogsQL 中不存在 grep 管道,| filter 仅在 | stats 之后用于过滤聚合结果;时间范围应放在 API 参数或 _time: 过滤中,不要同时使用;流字段名取决于采集配置,需先发现;搜索 error 时建议排除 vmselect 相关噪声。未提供的信息此处不作补充。