OpenTSDB 可视化查询工具

在线 OpenTSDB 时序数据库可视化查询工具,支持连接测试、JSON 查询执行和 Metric 元数据浏览,结果以表格形式展示

JSON 查询 凭据不存储 表格展示

连接配置

查询体 (JSON)

POST /api/query
等待操作…

暂无查询结果,请先执行查询

广告位

工具介绍与功能

OpenTSDB 可视化查询工具是一款在线时序数据库管理工具,基于 OpenTSDB HTTP API,让用户无需安装客户端即可通过浏览器执行查询、浏览 Metric 元数据和测试连接。

  • JSON 查询体:支持完整的 OpenTSDB /api/query JSON 查询格式
  • 连接测试:通过 GET /api/version 检测服务可用性并返回版本信息
  • Metric 浏览:通过 /api/suggest 列出所有可用 Metric 名称
  • 表格展示:查询结果的 dps 自动展开为 metric/timestamp/value 三列表格

安全保障

  • 凭据不存储:连接信息仅随请求透传,服务端不持久化任何凭据
  • 只读查询:工具设计为只读查询模式,适合数据浏览和分析
  • 超时控制:支持自定义查询超时时间,避免长时间阻塞
  • 行数限制:结果行数可配置上限,防止大数据集导致浏览器卡顿

常见问题

OpenTSDB 查询体如何编写?

查询体是一个 JSON 对象,包含 start(起始时间,如 "1h-ago")和 queries 数组。每个查询包含 metric(指标名)和 aggregator(聚合函数,如 sum/avg/max/min)。例如:{"start":"1h-ago","queries":[{"metric":"sys.cpu","aggregator":"sum"}]}。

结果表格中的 timestamp 是什么格式?

OpenTSDB 返回的 dps(data points)中,timestamp 是 Unix 时间戳(秒或毫秒),value 是对应的数值。本工具将每个 dps 展开为一行,列名为 metric、timestamp、value,方便查看每个数据点。

如何按 tag 过滤查询?

在查询的 queries 数组中添加 filters 字段。例如:{"metric":"sys.cpu","aggregator":"sum","filters":[{"type":"literal_or","tagk":"host","filter":"web01"}]}。这会只查询 host=web01 的数据点。

连接失败如何排查?

1)检查主机和端口是否正确(默认 4242);2)确认 OpenTSDB 服务已启动;3)检查防火墙是否允许访问;4)查看错误信息中的 HTTP 状态码和响应体定位问题;5)如需降级处理,可检查 /api/version 接口是否可访问。