请求路径和方法

请求路径 请求方法 描述
/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]
    ]
  }
]