单值查询时间线最新数据点_单值查询操作_HTTP API 参考_时序数据库 TSDB_时序时空数据库TSDB_阿里云技术文档

请求路径和方法

请求路径	请求方法	描述
/api/query/last	POST	获得时间线最新写入的数据点

注意：此端口完全兼容 OpenTSDB 协议。

请求内容

请求内容JSON格式

名字	类型	是否必需	描述	默认值	举例
queries	Array	是	子查询数组	无	见子查询说明
timestamp	Long	否	unix 时间戳，单位为秒或者毫秒，指定该参数时表示查询到该时间戳为止最新的数据点，否则表示查询当前最新的数据点	无	1539763573

子查询JSON格式

子查询中可以指定“Metric查询”格式或 “TSUID查询”格式。前者是通过指定时间线metric, tags作为检索条件执行查询；后者则是直接指定时间线的唯一ID来执行查询。在子查询的列表中，两种格式可以共存。

Metric 查询

名称	类型	是否必需	描述	默认值	举例
metric	String	是	待查询最新数据点的 Metric	无	cpu.usage
tags	String	否	待查询最新数据点的 Tags	无	host_name=host1

TSUID 查询

名称	类型	是否必需	描述	默认值	举例
tsuid	String	是	待查询最新数据点的 TSUID	无	00005B00005C0000F000005D0000EE00005E0000EF

注意：时间线的 TSUID 可以通过 /api/search/lookup 接口查询。

请求 JSON 示例

任务：

查询包含 metric 名字为“cpu.usage” 和 tag 名字为“host_name=host1”的时间线的最新写入数据点。

同时，查询包含 TSUID 为00005B00005C00002E00005D0000EE00005E0000EF和00005B00005C0000F000005D0000EE00005E0000EF两条时间线的最新写入数据点。

请求： POST/api/query/last

请求体：

{
    "queries" : [
        {
            "metric":"cpu.usage",
            "tags" : {
                "host_name": "host1"
            }
        },
        {
            "tsuids": [
                "00005B00005C00002E00005D0000EE00005E0000EF",
                "00005B00005C0000F000005D0000EE00005E0000EF"
            ]
        }
    ]
}

响应说明

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

名称	描述
metric	指标名
timestamp	最新数据点的时间戳
value	指标值
tags	数据点对应的tag键值集合
tsuid	数据点对应的时间线ID

响应体：

[{
    "metric": "cpu.usage",
    "timestamp": 1556418300000,
    "value": 30.3,
    "tags": {
        "host_name": "host1"
    },
    "tsuid": "00005B00005C00001D",
}, {
    "metric": "cpu.usage",
    "timestamp": 1556418300000,
    "value": 25.6,
    "tags": {
        "host_name": "host2",
        "cluster": "cluster1"
        "zone": "zone1"
    },
    "tsuid": "00005B00005C00002E00005D0000EE00005E0000EFE",
}, {
    "metric": "cpu.usage",
    "timestamp": 1556418300000,
    "value": 43.1,
    "tags": {
        "host_name": "host3",
        "cluster": "cluster1"
        "zone": "zone1"
    },
    "tsuid": "00005B00005C0000F000005D0000EE00005E0000EF",
}]

单值查询时间线最新数据点_单值查询操作_HTTP API 参考_时序数据库 TSDB_时序时空数据库TSDB

单值查询时间线最新数据点