HiTSDB 支持通过 HTTP API 方式进行数据读取,关于数据读取的指导说明,请参考《开发指南》:
数据读取
HiTSDB 同时支持通过控制台,对数据进行查询,可以设置时间、度量(Metric)和标签(Tag)等查询条件。
操作步骤
在 HiTSDB 控制台 的集群列表页面中,在需要进行数据查询的实例所在行的操作列单击 管理。
在实例详情页面左侧的导航栏中单击 数据查询。
在数据查询页面设置查询条件。

在时间选择右侧的时间选择框中,选择要查询的起始日期和结束如期。
必选项。默认为起始日期的 0 点到结束日期的当前时间。也可以手动输入具体日期和时间。
在度量(Metric)选择右侧的下拉框中选择度量,必选项。
在空间聚合右侧选择度量的聚合方式,必选项。
如果最终同一个度量(Metric)会有多条时间线产生(多个指标采集设备),那么为了将空间的多维数据,展现为成同一条时间线,需要进行空间聚合。聚合方式包括 avg、count、sum、max 和 min。
在标签(Tag)选择右侧单击 添加,在弹出的对话框中添加 标签(Tag)和标签值(TagValue),可选项。
支持多个标签混合筛选。
- 相同 Tag,不同 TagValue 之间 是 “或” 的关系,如 city = 北京 or 上海。
- 不同 Tag 之间是 “与” 的关系。如 City = 北京 and region = 海淀。
在分组右侧的下拉框中选择分组,然后单击 添加。
分组用于在多个分组之间进行数据对比,支持按照 Tag 和 TagValue 分组,可选项。
- 单个 Tag,多个 TagValue 之间生成多个分组。
- 多个 Tag 的 TagValue 之间生成若干的笛卡尔积组合分组。
滑动降精度右侧的滑块,开启 或 关闭 降精度功能。
HiTSDB 原始数据采集的时间精度为秒,降低时间精度(降精度)默认关闭,按照采集的精度展现数据。
如果觉得当前的时间精度过高,没有必要,或者需要从更宏观的时间区间查看数据(如:30分钟,12小时),则可以开启降精度功能。
降精度功能开启后,会弹出精度选择对话框,选择 聚合函数 及 时间采样。时间采样包括:5分钟、15分钟、30分钟、1小时、12小时和24小时。
查询条件设置完成后,单击 查询。
结果验证
查询的数据结果以坐标图形化的形式展现。纵坐标为数据度量指标(Metric),横坐标为时间。