单值查询时间线最新数据点
请求路径和方法
请求路径 | 请求方法 | 描述 |
---|---|---|
/api/query/last | POST | 获得时间线最新写入的数据点 |
请求内容
请求内容 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": "sys.cpu.nice",
"tags": {
"host": "web01"
}
},
{
"tsuids": [
"eyJtZXRyaWMiOiJzeXMuY3B1Lm5pY2UiLCJ0YWdzIjp7ImRjIjoibGdhIiwiaG9zdCI6IndlYjA0In19",
"eyJtZXRyaWMiOiJzeXMuY3B1Lm5pY2UiLCJ0YWdzIjp7ImRjIjoibGdhIiwiaG9zdCI6IndlYjAyIn19"
]
}
]
}
响应说明
查询成功的 HTTP 响应码为 200,返回符合条件的时间线最新数据点,内容为 JSON 格式数据;如果没有时间线满足条件,则返还空集。
响应体:
[
{
"aggregatedTags": [],
"dps": {
"1346846400": 18
},
"metric": "sys.cpu.nice",
"tags": {
"dc": "lga",
"host": "web01"
}
},
{
"aggregatedTags": [],
"dps": {
"1346846400": 10
},
"metric": "sys.cpu.nice",
"tags": {
"dc": "lga",
"host": "web04"
}
},
{
"aggregatedTags": [],
"dps": {
"1346846400": 9
},
"metric": "sys.cpu.nice",
"tags": {
"dc": "lga",
"host": "web02"
}
}
]
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论