opentsdb-goclient

README

##opentsdb-goclient

###Backgroud OpenTSDB is a distributed, scalable Time Series Database (TSDB) written on top of HBase. OpenTSDB was written to address a common need: store, index and serve metrics collected from computer systems (network gear, operating systems, applications) at a large scale, and make this data easily accessible and graphable.

I am about to use OpenTSDB, but currently there is no useable go-sdk for OpenTSDB. So I develop the opentsdb-goclient for convenience according to the [OpenTSDB Rest API Doc] (http://opentsdb.net/docs/build/html/api_http/index.html#api-endpoints)

###How to use sample If you want to see how does the sample (sample.go) run, you can execute the following commands:

cd $GOPATH
mkdir -p $GOPATH/src/github.com/bluebreezecf
cd $GOPATH/src/github.com/bluebreezecf
git clone https://github.com/bluebreezecf/opentsdb-goclient.git

vi sample.go //Use the real host and port of an existing OpenTSDB in Line 33: OpentsdbHost: "127.0.0.1:4242"
go run sample.go

###Current supporting rest apis

GET             /api/aggregators
GET,POST,DELETE /api/annotation
POST,DELETE     /api/annotation/bulk
GET 			/api/config
GET 			/api/dropcaches
POST 			/api/put
GET				/api/query
GET 			/api/serializers
GET 			/api/stats
GET				/api/suggest
POST			/api/uid/assign
GET,POST,DELETE /api/uid/tsmeta
GET,POST,DELETE /api/uid/uidmeta
GET 			/api/version

Documentation

Overview

Copyright 2015 opentsdb-goclient authors. All Rights Reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Package main shows the sample of how to use github.com/bluebreezecf/opentsdbclient/client to communicate with the OpenTSDB with the pre-define rest apis. (http://opentsdb.net/docs/build/html/api_http/index.html#api-endpoints)