文档首页 > > 开发指南> 对外接口> OpenTSDB API> 查询last数据

查询last数据

分享
更新时间:2020/06/17 GMT+08:00

功能介绍

指定Metric或tsuid查询时间戳最新的一条DataPoint。

如果该Metric或tsuid最新的时间戳有多条不同tag的DataPoint,查询只返回一条DataPoint,时间戳单位是毫秒。

URI

  • URI格式

    POST {OpenTSDB URL}/api/query/last

请求

  • 请求样例(指定Metric)
    {
    	"resolveNames":true,
    	"backScan":20,
    	"queries":[
    		{
    			"metric":"sys.cpu.nice"
    		},
    		{
    			"metric":"cpu.system"
    		}
    	]
    }
  • 请求样例(指定Metric和Tag)
    {	
    	"resolveNames":true,	
    	"backScan":20,	
    	"queries":[		
    	      {			
    		"metric":"sys.cpu.nice",
    		"tags": {
    				"host": "web01",
    				"dc": "lga"
    			}
    	      },		
    	      {			
    		"metric":"cpu.system",
    		"tags": {
    				"host": "web01",
    				"dc": "lga"
    			}
    	      }
    	]
    }
  • 请求样例(指定tsuid)
    {	
    	"resolveNames":true,	
    	"backScan":20,	
    	"queries":[		
                 {
                     "tsuids": [
                                    "00000E0000090007E500000A0007E6",
                                    "00000F0000090007E500000A0007E6"
                               ]
                  }
    	]
    }
  • 参数说明
    表1 请求参数说明

    名称

    类型

    是否必须

    描述

    resolveNames

    Boolean

    是否将返回结果的tsuid转换为对应的metric、Tagk和Tagv名称。

    • true:转换
    • false:不转换

    backScan

    Integer

    设置需要扫描过去几个小时的数据,单位:小时。

    数据存储以小时为单位,假设系统当前时间是2018/07/20 19:30:00,“backScan”设置为2:

    • 如果“queries”的子查询中只指定了“metric”,没有指定“tags”“tsuids”,则该子查询的时间范围是2018/07/20 17:00:00到2106/01/01 00:00:00,数据扫描会从2106/01/01 00:00:00开始往前直到找到最新的一条数据。
    • 如果“queries”的子查询中同时指定了“metric”“tags”,或指定了“tsuids”,则该子查询的时间范围是2018/07/20 17:00:00到当前时间2018/07/20 19:30:00,数据扫描会从2018/07/20 19:30:00开始往前直到找到最新的一条数据。
    • 如果“backScan”不设置或者值为0,表示扫描所有时间。

    queries

    Array

    需要查询的metric、tag、tsuid列表,可以有多个子查询。请参见表2

    表2 queries参数说明

    名称

    类型

    是否必须

    描述

    metric

    String

    指标名称

    tags

    Map

    Tagk和Tagv的键值对

    tsuids

    List

    metric、Tagk和Tagv对应的tsuid

    “queries”的子查询中,“metric”“tsuids”必须要有一个。

响应

  • 响应样例
    [
        {
            "metric": "sys.cpu.nice",
            "timestamp": 1346846400000,
            "value": "18",
            "tags": {
                "host": "web01",
                "dc": "lga"
            },
            "tsuid": "00000E0000090007E500000A0007E6"
        },
        {
            "metric": "cpu.system",
            "timestamp": 1346846400000,
            "value": "9",
            "tags": {
                "host": "web02",
                "dc": "lga"
            },
            "tsuid": "00000F0000090007E700000A0007E6"
        }
    ]
  • 参数说明
    表3 响应参数说明

    名称

    类型

    描述

    metric

    String

    指标名称

    timestamp

    long

    时间戳,单位:毫秒

    value

    String

    数据值

    tags

    Map

    Tagk和Tagv的键值对

    tsuid

    String

    metric、Tagk和Tagv对应的tsuid

状态码

状态码请参见响应码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问