Prometheus 查询可视化工具
在线连接 Prometheus 实例,执行 PromQL 即时/范围查询并浏览指标元数据
连接配置
暂无数据,执行查询后将在此展示结果
工具介绍
Prometheus 是云原生领域最流行的监控与告警系统,采用 PromQL(Prometheus Query Language)对时序数据进行多维查询与聚合。本工具帮助你在浏览器中直接连接 Prometheus 实例,执行即时查询与范围查询,并将结果以表格形式可视化展示。
- 即时查询:调用
/api/v1/query,返回某一时刻的向量/标量结果。 - 范围查询:调用
/api/v1/query_range,需指定 start、end、step,返回矩阵数据。 - 指标元数据:调用
/api/v1/label/__name__/values,列出所有指标名称。
安全说明
- 凭据不持久化:连接信息(主机/端口/账号密码)仅随请求在内存中透传给后端代理,不写入数据库或日志。
- 只读查询:本工具仅发起 Prometheus HTTP API 的查询类请求,不执行任何写操作。
- 本地存储:前端仅把连接配置保存到当前页面的 sessionStorage,关闭标签页即清除。
- 超时控制:请求超时与结果行数上限均可自定义,避免拉取超大结果集。
常见问题
连接测试失败如何排查?
1)确认 Prometheus 服务已启动且端口(默认 9090)可达;2)若启用了反向代理或 Basic Auth,请填写正确的用户名密码;3)跨域/网络隔离环境下,需保证本服务后端能访问到 Prometheus 实例;4)查看返回的错误信息,HTTP 非 200 即视为连接失败。
即时查询和范围查询的区别?
即时查询返回某一时刻(默认当前)的值,结果类型通常为 vector 或 scalar;范围查询返回一段时间区间内的多个采样点,结果类型为 matrix,需要提供 start(起始 Unix 秒)、end(结束 Unix 秒)、step(步长,如 15s、1m)三个参数。
结果表格中的列是怎么生成的?
对于 vector/matrix 结果,工具会收集所有时间序列的 metric 标签 key(如 __name__、job、instance 等)作为前几列,并在末尾追加 timestamp、value 两列;缺失的标签值以空字符串填充。scalar/string 结果仅返回单列 result。
支持哪些常用的 PromQL 示例?
up(目标存活状态)、node_cpu_seconds_total(CPU 使用)、rate(http_requests_total[5m])(5 分钟请求速率)、sum by (job)(up)(按 job 聚合)等。