全部产品
云市场

多值查询最新数据点

更新时间:2019-06-25 17:18:02

多值模型最新数据点查询(新建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请求体:

  1. {
  2. "tupleFormat": true,
  3. "tupleOffset":5,
  4. "tupleLimit":100,
  5. "timestamp" : 1551851846,
  6. "queries": [
  7. {
  8. "metric": "cpu",
  9. "fields": ["usage_system", "usage_idle"],
  10. "tags": {
  11. "host_name": "host1"
  12. }
  13. }
  14. ]
  15. }

响应说明

查询成功的 HTTP 响应码为 200,返回符合条件的时间线最新数据点,内容为JSON 格式数据;如果没有时间线满足条件,则返还空集。JSON说明如下:

名称 描述
metric 指标名
columns 返回结果集中的列名称,包括时间戳和查询的域名称
tags 数据点对应的tag键值集合
values 查询指标域的值,值的顺序和 columns 的顺序对应

注意 如果将 tupleFormat 设置成 false,增返回结果格式跟单值模型一致。这种场景下的详细响应内容可以参考 /api/query/last 接口的介绍

返回结果 JSON 示例

  1. [
  2. {
  3. "metric": "wind",
  4. "columns": [
  5. "timestamp",
  6. "level",
  7. "speed"
  8. ],
  9. "tags": {
  10. "city": "hangzhou",
  11. "country": "china",
  12. "province": "zhejiang",
  13. "sensor": "IOTE_8859_0001"
  14. },
  15. "values": [
  16. [1346846405000, 5.1, 45.1]
  17. ]
  18. }
  19. ]