多值查询最新数据点
多值模型最新数据点查询(新建mlast)
请求路径和方法
请求路径 | 请求方法 | 描述 |
---|---|---|
/api/query/mlast | POST | 获得多值模型指标数据中 fields 最新写入的数据点 |
请求内容
名称 | 类型 | 是否必需 | 描述 | 默认值 | 举例 |
---|---|---|---|---|---|
queries | Array | 是 | 子查询数组。 | 无 | 见子查询说明 |
timestamp | Long | 否 | unix 时间戳,单位为秒或者毫秒,指定该参数时表示查询到该时间戳为止最新的数据点,否则表示查询当前最新的数据点 Tags。这个是和 queries 相同级别参数,详情见示例。 | 无 | 1539763573 |
tupleFormat | Boolean | 否 | 将查询 fields 的最新数据点元组结构返回,详情见示例。 | false | false |
tupleOffset | Long | 否 | 数据分页时返回的tuple的偏移量。仅在tupleFormat为true时有效。 | 0 | 5 |
tupleLimit | Long | 否 | 数据分页时返回的tuple最大数量。仅在tupleFormat为true时有效。 | 0 | 100 |
注意:/api/query/mlast 只能用于多值模型数据,单值模型数据的最新数据点,请使用 /api/query/last 接口。
子查询JSON格式
名称 | 类型 | 是否必需 | 描述 | 默认值 | 举例 |
---|---|---|---|---|---|
metric | String | 是 | 待查询最新数据点的 Metric。 | 无 | wind |
fields | List | 是 | 需要查询最新数据点的域, “*”代表查询 metric 下所有域。 | 无 | {speed, level, description} |
tags | String | 否 | 待查询最新数据点的 Tags。 | 无 | sensor = IOTE_1988_0001 |
请求 JSON 示例
任务:查询 “cpu” 指标下,标签为 “host_name=host1” 的 “usage_system” 和 “usage_idle” 域最新写入数据点。请求: POST/api/query/mlast
请求体:
{
"tupleFormat": true,
"tupleOffset":5,
"tupleLimit":100,
"timestamp" : 1551851846,
"queries": [
{
"metric": "cpu",
"fields": ["usage_system", "usage_idle"],
"tags": {
"host_name": "host1"
}
}
]
}
响应说明
查询成功的 HTTP 响应码为 200,返回符合条件的时间线最新数据点,内容为JSON 格式数据;如果没有时间线满足条件,则返还空集。JSON说明如下:
名称 | 描述 |
---|---|
metric | 指标名 |
columns | 返回结果集中的列名称,包括时间戳和查询的域名称 |
tags | 数据点对应的tag键值集合 |
values | 查询指标域的值,值的顺序和 columns 的顺序对应 |
注意 如果将 tupleFormat 设置成 false,增返回结果格式跟单值模型一致。这种场景下的详细响应内容可以参考 /api/query/last 接口的介绍。
返回结果 JSON 示例
[
{
"metric": "wind",
"columns": [
"timestamp",
"level",
"speed"
],
"tags": {
"city": "hangzhou",
"country": "china",
"province": "zhejiang",
"sensor": "IOTE_8859_0001"
},
"values": [
[1346846405000, 5.1, 45.1]
]
}
]
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论