openTSDB.net

Notice: This is not the openTSD.net web page repository. If you are looking for this then try HERE

Introduction

openTSDB.net is a low weight, low impact implementation of a application to OpenTSDB bridge.

Scope

Although the openTSDB API is powerfull this library concentrates on one thing.

Getting data into the openTSDB

This is the only concern of this library. If you want a more complete interaction model then please contact me.

Installation

NuGet

PM> Install-Package openTSDB.net

Glossary

Getting started

Hit the ground running

Working the factory

OpenTsdb.net uses a factory pattern to provide "unknown" and named instances of the manager.

Named instances

var tsdbManager = OpenTsdbFactory.Instance(TsdbOptions.New("http://localhost:4242"), "myInstance");

Where myInstance is the instance identifier.

If the instance was already initialized by someone else then the same instance will be returned.

Anonymous instance

var tsdbManager = OpenTsdbFactory.Instance(TsdbOptions.New("http://localhost:4242"));

Publishing data

The point of this all is to get data into the openTSDB database.

This can be done...

Quick and easy

If we want to publish only one data point then this can easily be achieved by

tsdbManager.PushAsync<int>("login", 1);

More control more code

There is also a longer way that provides more control over the data transmitted.

var dataPoint = new DataPoint<int>
{
    Value = 23,
    Metric = "user_age",
    Timestamp = DateTime.Now.ToEpoch(),
    Tags = new TagsCollection()
};

var result = tsdbManager.PushAsync<int>(dataPoint);