Skip to content

Latest commit

 

History

History
39 lines (31 loc) · 1.42 KB

README.md

File metadata and controls

39 lines (31 loc) · 1.42 KB

tspark

TimeSeries Java client for Facebook Beringei. It also includes query service with tags support for metrics.

Prerequisites - Download and deploy the beringei server from facebook

https://github.com/facebookincubator/beringei

Start the Beringei Server

./beringei_main -beringei_configuration_path /beringeidata/beringei.json -data_directory /beringeidata/data -port 9999 -create_directories -sleep_between_bucket_finalization_secs 60 -allowed_timestamp_behind 900 -bucket_size 1200 -buckets 144 -mintimestampdelta 0 -logtostderr -v=1

Building the Beringei Java Client

mvn clean package

This creates the following jar files

beringeiclient/target/beringeiclient-0.0.1-SNAPSHOT.jar
TSPark/target/TSPark-0.0.1-SNAPSHOT.jar
dist/target/TSPark-jar-with-dependencies.jar (fat jar)

Samples

Send & Retrieve metrics data using Java Client

Grafana dashboards

Setting up the grafana

Add data source - sample http://127.0.0.1:58080/tsdb

Installing the dashboards

Accesing the data from grafana

Importing the dashboard from the sample json file

Features

Store and Retieve Metrics to/from Beringei

Aggregations

QueryService APIs

http://<host>:<port>/tsdb/api/query
http://<host>:<port>/tsdb/api/aggregators
http://<host>:<port>/tsdb/api/suggest

(Default sample)	
http://127.0.0.1:58080/tsdb/api/query
http://127.0.0.1:58080/tsdb/api/aggregators
http://127.0.0.1:58080/tsdb/api/suggest