全部产品
云市场

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

更新时间:2019-12-27 10:56:10

请求路径和方法

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

请求: POST /api/query/last

请求体:

  1. {
  2. "queries": [
  3. {
  4. "metric": "sys.cpu.nice",
  5. "tags": {
  6. "host": "web01"
  7. }
  8. },
  9. {
  10. "tsuids": [
  11. "eyJtZXRyaWMiOiJzeXMuY3B1Lm5pY2UiLCJ0YWdzIjp7ImRjIjoibGdhIiwiaG9zdCI6IndlYjA0In19",
  12. "eyJtZXRyaWMiOiJzeXMuY3B1Lm5pY2UiLCJ0YWdzIjp7ImRjIjoibGdhIiwiaG9zdCI6IndlYjAyIn19"
  13. ]
  14. }
  15. ]
  16. }

响应说明

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

响应体:

  1. [
  2. {
  3. "aggregatedTags": [],
  4. "dps": {
  5. "1346846400": 18
  6. },
  7. "metric": "sys.cpu.nice",
  8. "tags": {
  9. "dc": "lga",
  10. "host": "web01"
  11. }
  12. },
  13. {
  14. "aggregatedTags": [],
  15. "dps": {
  16. "1346846400": 10
  17. },
  18. "metric": "sys.cpu.nice",
  19. "tags": {
  20. "dc": "lga",
  21. "host": "web04"
  22. }
  23. },
  24. {
  25. "aggregatedTags": [],
  26. "dps": {
  27. "1346846400": 9
  28. },
  29. "metric": "sys.cpu.nice",
  30. "tags": {
  31. "dc": "lga",
  32. "host": "web02"
  33. }
  34. }
  35. ]