查询first数据
功能介绍
指定Metric查询时间戳最早的一条DataPoint。
如果该Metric最早的时间戳有多条不同tag的DataPoint,查询只返回一条DataPoint,时间戳单位是毫秒。
请求
- 请求样例
{ "resolveNames":true, "backScan":20, "queries":[ { "metric":"sys.cpu.nice" }, { "metric":"cpu.system" } ] }
- 参数说明
表1 请求参数说明 名称
类型
是否必须
描述
resolveNames
Boolean
否
是否将返回结果的tsuid转换为对应的metric、Tagk和Tagv名称。
- true:转换
- false:不转换
backScan
Integer
否
设置需要扫描过去几个小时的数据,单位:小时。
数据存储以小时为单位,假设系统当前时间是2018/07/20 19:30:00,“backScan”设置为2,则查询的时间范围是2018/07/20 17:00:00到2106/01/01 00:00:00,而不是从2018/07/20 17:30:00开始,数据扫描会从2018/07/20 17:00:00开始直到找到第一条数据。
如果“backScan”不设置或者值为0,表示扫描所有时间。
queries
Array
是
需要查询的metric列表,不支持指定Tag和tsuid,可以有多个子查询。
响应
- 响应样例
[ { "metric": "sys.cpu.nice", "timestamp": 1346846400000, "value": "18", "tags": { "host": "web01", "dc": "lga" }, "tsuid": "00000E0000090007E500000A0007E6" }, { "metric": "cpu.system", "timestamp": 1346846400000, "value": "9", "tags": { "host": "web02", "dc": "lga" }, "tsuid": "00000F0000090007E700000A0007E6" } ]
- 参数说明
表2 响应参数说明 名称
类型
描述
metric
String
指标名称
timestamp
long
时间戳,单位:毫秒
value
String
数据值
tags
Map
Tagk和Tagv的键值对
tsuid
String
metric、Tagk和Tagv对应的tsuid
状态码
状态码请参见响应码
