全部产品

基本说明

更新时间:2019-04-01 10:57:19

基本说明

云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

  1. {
  2. "error": {
  3. "code": 400,
  4. "message": "Missing parameter <code>type</code>",
  5. "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]
  6. ....\r\n\tat java.lang.Thread.run(Unknown Source) [na:1.6.0_26]\r\n"
  7. }
  8. }

常见问题

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

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