metrics_influxdb

Class InfluxdbHttp

java.lang.Object

metrics_influxdb.InfluxdbHttp

public class InfluxdbHttp
extends java.lang.Object

A client to send data to a InfluxDB server via HTTP protocol. The usage :

   Influxdb influxdb = new Influxdb(...);

   influxdb.appendSeries(...);
   ...
   influxdb.appendSeries(...);
   influxdb.sendRequest();

   influxdb.appendSeries(...);
   ...
   influxdb.appendSeries(...);
   influxdb.sendRequest();

 

Field Summary

Fields

Modifier and Type	Field and Description
boolean	debugJson if true then print Json on System.err
metrics_influxdb.JsonBuilder	jsonBuilder
java.net.URL	url

Constructor Summary

Constructors

Constructor and Description
InfluxdbHttp(java.lang.String host, int port, java.lang.String database, java.lang.String username, java.lang.String password) Constructor with the InfluxDB time_precision parameter set to TimeUnit.MILLISECONDS
InfluxdbHttp(java.lang.String host, int port, java.lang.String path, java.lang.String database, java.lang.String username, java.lang.String password) Constructor with the InfluxDB time_precision parameter set to TimeUnit.MILLISECONDS
InfluxdbHttp(java.lang.String host, int port, java.lang.String path, java.lang.String database, java.lang.String username, java.lang.String password, java.util.concurrent.TimeUnit timePrecision)
InfluxdbHttp(java.lang.String host, int port, java.lang.String database, java.lang.String username, java.lang.String password, java.util.concurrent.TimeUnit timePrecision)

Method Summary

Modifier and Type	Method and Description
void	appendSeries(java.lang.String namePrefix, java.lang.String name, java.lang.String nameSuffix, java.lang.String[] columns, java.lang.Object[][] points)
long	convertTimestamp(long timestamp)
boolean	hasSeriesData() Returns true if the pending request has metrics to report.
void	resetRequest() Forgot previously appendSeries.
int	sendRequest(boolean throwExc, boolean printJson)
static java.lang.String	toTimePrecision(java.util.concurrent.TimeUnit t)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

url

public final java.net.URL url

debugJson

public boolean debugJson

if true then print Json on System.err

jsonBuilder

public metrics_influxdb.JsonBuilder jsonBuilder

Constructor Detail

InfluxdbHttp

public InfluxdbHttp(java.lang.String host,
                    int port,
                    java.lang.String database,
                    java.lang.String username,
                    java.lang.String password)
             throws java.lang.Exception

Constructor with the InfluxDB time_precision parameter set to TimeUnit.MILLISECONDS

Throws:

java.io.IOException - If the URL is malformed

java.lang.Exception

InfluxdbHttp

public InfluxdbHttp(java.lang.String host,
                    int port,
                    java.lang.String path,
                    java.lang.String database,
                    java.lang.String username,
                    java.lang.String password)
             throws java.lang.Exception

Constructor with the InfluxDB time_precision parameter set to TimeUnit.MILLISECONDS

Throws:

java.io.IOException - If the URL is malformed

java.lang.Exception

InfluxdbHttp

public InfluxdbHttp(java.lang.String host,
                    int port,
                    java.lang.String database,
                    java.lang.String username,
                    java.lang.String password,
                    java.util.concurrent.TimeUnit timePrecision)
             throws java.lang.Exception

Parameters:

timePrecision - The precision of the epoch time that is sent to the server, should be TimeUnit.MILLISECONDS unless you are using a custom Clock that does not return milliseconds epoch time for getTime()

Throws:

java.io.IOException - If the URL is malformed

java.lang.Exception

InfluxdbHttp

public InfluxdbHttp(java.lang.String host,
                    int port,
                    java.lang.String path,
                    java.lang.String database,
                    java.lang.String username,
                    java.lang.String password,
                    java.util.concurrent.TimeUnit timePrecision)
             throws java.lang.Exception

Parameters:

timePrecision - The precision of the epoch time that is sent to the server, should be TimeUnit.MILLISECONDS unless you are using a custom Clock that does not return milliseconds epoch time for getTime()

Throws:

java.io.IOException - If the URL is malformed

java.lang.Exception

Method Detail

toTimePrecision

public static java.lang.String toTimePrecision(java.util.concurrent.TimeUnit t)

hasSeriesData

public boolean hasSeriesData()

Returns true if the pending request has metrics to report.

convertTimestamp

public long convertTimestamp(long timestamp)

resetRequest

public void resetRequest()

Forgot previously appendSeries.

appendSeries

public void appendSeries(java.lang.String namePrefix,
                         java.lang.String name,
                         java.lang.String nameSuffix,
                         java.lang.String[] columns,
                         java.lang.Object[][] points)

sendRequest

public int sendRequest(boolean throwExc,
                       boolean printJson)
                throws java.lang.Exception

Throws:

java.lang.Exception