OpenTSDB 可视化查询工具
在线 OpenTSDB 时序数据库可视化查询工具,支持连接测试、JSON 查询执行和 Metric 元数据浏览,结果以表格形式展示
连接配置
查询体 (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 接口是否可访问。