基本说明

云OpenTSDB提供RESTful API，完全兼容社区版本OpenTSDB API。

HTTP Response Codes

成功的返回：

Code	Description
200	请求成功
204	请求成功，但是返回content为空。主要用于写入接口，无需返回数据。

异常的返回:

Code	Description
400	请求异常，通常来说可能是参数错误。
404	请求的endpoint不存在
405	endpoint不支持这个method
408	请求超时，可能是查询HBase时候超时导致或者其他问题。
413	返回结果太大，建议将查询切分成多个请求
500	内部错误，可能是OpenTSDB内核的bug
501	请求的接口并未实现
503	服务不可用，一般可能是负载过高了

Errors

如果发生错误，通常会返回如下信息

Field Name	Data Type	Always Present	Description	Example
code	Integer	Yes	HTTP status code	400
message	String	Yes	错误描述	Missing required parameter
details	String	Optional	错误细节，不一定有	Missing value: type
trace	String	Optional	java错误堆栈，不一定有	见下方

错误消息的HTTP返回码都是正常的（200），需要解析错误消息json。

Example Error Result

{
    "error": {
        "code": 400,
        "message": "Missing parameter <code>type</code>",
        "trace": "net.opentsdb.tsd.BadRequestException: Missing parameter <code>type</code>\r\n\tat net.opentsdb.tsd.BadRequestException.missingParameter(BadRequestException.java:78) ~[bin/:na]\r\n\tat net.opentsdb.tsd.HttpQuery.getRequiredQueryStringParam(HttpQuery.java:250) ~[bin/:na]\r\n\tat net.opentsdb.tsd.SuggestRpc.execute(SuggestRpc.java:63) ~[bin/:na]\r\n\tat net.opentsdb.tsd.RpcHandler.handleHttpQuery(RpcHandler.java:172) [bin/:na]\r\n\tat net.opentsdb.tsd.RpcHandler.messageReceived(RpcHandler.java:120) [bin/:na]\r\n\tat org.jboss.netty.channel.SimpleChannelUpstreamHandler.handleUpstream(SimpleChannelUpstreamHandler.java:75) [netty-3.5.9.Final.jar:na]\r\n\tat org.jboss.netty.channel.DefaultChannelPipeline.sendUpstream(DefaultChannelPipeline.java:565) [netty-3.5.9.Final.jar:na]
        ....\r\n\tat java.lang.Thread.run(Unknown Source) [na:1.6.0_26]\r\n"
    }
}

常见问题

1.请求过大根据购买的型号不同（CORE节点型号），能接受的最大请求大小也是有上限的，如果超过了连接会被reset。

型号	上限
4核16G	128KB
8核32G	256KB
16核64G	512KB
32核128G	1MB

基本说明_RESTful API_HBase OpenTSDB 时序引擎_云数据库 HBase 版

基本说明

基本说明

HTTP Response Codes

Errors

Example Error Result

常见问题

版权声明

评论