请求路径和方法

请求路径 请求方法 描述
/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
注意 这里不支持通过filters指定维度过滤条件,必须使用tags字段指定维度过滤条件。

TSUID 查询

名称 类型 是否必需 描述 默认值 举例
tsuid String 待查询最新数据点的 TSUID 00005B00005C0000F000005D0000EE00005E0000EF
注意
  • 时间线的 TSUID 可以通过 /api/search/lookup 接口查询。
  • 在高可用版本中,tsuid字段仅仅是形式上兼容,但不再支持tsuid查询功能。同样,在高可用版本中,/api/search/lookup 也不再支持返回tsuid值。

请求 JSON 示例

任务:

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

同时,查询包含 TSUID 为00005B00005C00002E00005D0000EE00005E0000EF00005B00005C0000F000005D0000EE00005E0000EF两条时间线的最新写入数据点。

请求: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",
}]