SuperAPI AI 工具集

prometheus-api

编程与开发

查看项目

更新于 10-16 09:57

技能介绍

用途:该技能用于通过 Prometheus 的 HTTP API(/api/v1)查询监控数据,适合需要执行 PromQL 查询或读取 Prometheus 状态信息的场景。

主要能力:支持即时查询 /api/v1/query 与范围查询 /api/v1/query_range,可格式化 PromQL(/api/v1/format_query)、按标签查找时序(/api/v1/series)、列出标签名与标签值(/api/v1/labels、/api/v1/label/<name>/values)、查询 exemplars。还可读取元数据与状态类端点,包括 targets、metadata、rules、alerts、alertmanagers,以及 status/config、status/flags、status/runtimeinfo、status/buildinfo、status/tsdb、status/walreplay。管理端点(需启用 --web.enable-admin-api)支持创建 TSDB 快照、删除时序、清理 tombstone。

使用方式:可用 curl 直接调用,例如即时查询 curl 'http://<prometheus>:9090/api/v1/query?query=<promql>&time=<timestamp>';范围查询 curl 'http://<prometheus>:9090/api/v1/query_range?query=<promql>&start=<ts>&end=<ts>&step=<duration>'。仓库提供脚本 scripts/prom_query.py,支持即时与范围查询并输出 table、json、csv 格式;scripts/prom_health.py 用于健康检查。

结果与限制:响应均为 JSON,包含 status、data、errorType、error、warnings 字段;HTTP 状态码 400 表示参数错误、422 表示表达式错误、503 表示超时。管理类端点默认不可用,需开启 --web.enable-admin-api。详细 API 与 PromQL 说明见 references/api_reference.md 和 references/promql_functions.md。暂未提供其他收费、价格或平台相关信息。