全部产品

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

更新时间:2019-04-30 09:57:10

请求路径和方法

请求路径 请求方法 描述
/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 为00005B00005C00002E00005D0000EE00005E0000EF00005B00005C0000F000005D0000EE00005E0000EF两条时间线的最新写入数据点。

请求: POST/api/query/last

请求体:

  1. {
  2. "queries" : [
  3. {
  4. "metric":"cpu.usage",
  5. "tags" : {
  6. "host_name": "host1"
  7. }
  8. },
  9. {
  10. "tsuids": [
  11. "00005B00005C00002E00005D0000EE00005E0000EF",
  12. "00005B00005C0000F000005D0000EE00005E0000EF"
  13. ]
  14. }
  15. ]
  16. }

响应说明

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

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

响应体:

  1. [{
  2. "metric": "cpu.usage",
  3. "timestamp": 1556418300000,
  4. "value": 30.3,
  5. "tags": {
  6. "host_name": "host1"
  7. },
  8. "tsuid": "00005B00005C00001D",
  9. }, {
  10. "metric": "cpu.usage",
  11. "timestamp": 1556418300000,
  12. "value": 25.6,
  13. "tags": {
  14. "host_name": "host2",
  15. "cluster": "cluster1"
  16. "zone": "zone1"
  17. },
  18. "tsuid": "00005B00005C00002E00005D0000EE00005E0000EFE",
  19. }, {
  20. "metric": "cpu.usage",
  21. "timestamp": 1556418300000,
  22. "value": 43.1,
  23. "tags": {
  24. "host_name": "host3",
  25. "cluster": "cluster1"
  26. "zone": "zone1"
  27. },
  28. "tsuid": "00005B00005C0000F000005D0000EE00005E0000EF",
  29. }]