单值查询时间线最新数据点
请求路径和方法
请求路径 | 请求方法 | 描述 |
---|---|---|
/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",
}]
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论