基本说明
基本说明
云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 |
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论