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

查询first数据

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

功能介绍

指定Metric查询时间戳最早的一条DataPoint。

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

URI

  • URI格式

    POST {OpenTSDB URL}/api/query/first

请求

  • 请求样例
    {
    	"resolveNames":true,
    	"backScan":20,
    	"queries":[
    		{
    			"metric":"sys.cpu.nice"
    		},
    		{
    			"metric":"cpu.system"
    		}
    	]
    }
  • 参数说明
    表1 请求参数说明

    名称

    类型

    是否必须

    描述

    resolveNames

    Boolean

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

    • true:转换
    • false:不转换

    backScan

    Integer

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

    数据存储以小时为单位,假设系统当前时间是2018/07/20 19:30:00,“backScan”设置为2,则查询的时间范围是2018/07/20 17:00:00到2106/01/01 00:00:00,而不是从2018/07/20 17:30:00开始,数据扫描会从2018/07/20 17:00:00开始直到找到第一条数据。

    如果“backScan”不设置或者值为0,表示扫描所有时间。

    queries

    Array

    需要查询的metric列表,不支持指定Tag和tsuid,可以有多个子查询。

响应

  • 响应样例
    [
        {
            "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"
        }
    ]
  • 参数说明
    表2 响应参数说明

    名称

    类型

    描述

    metric

    String

    指标名称

    timestamp

    long

    时间戳,单位:毫秒

    value

    String

    数据值

    tags

    Map

    Tagk和Tagv的键值对

    tsuid

    String

    metric、Tagk和Tagv对应的tsuid

状态码

状态码请参见响应码

分享:

    相关文档

    相关产品

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

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

*必选

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

字符长度不能超过200

提交反馈 取消

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

智能客服提问云社区提问