com.wavefront.integrations

Interface WavefrontSender

All Superinterfaces:

AutoCloseable, Closeable

All Known Implementing Classes:

Wavefront

public interface WavefrontSender
extends Closeable

Wavefront Client that sends data directly via TCP to the Wavefront Proxy Agent.

Author:

Clement Pang ([email protected])., Conor Beverland ([email protected]).

Method Summary

Modifier and Type	Method and Description
void	connect() Connects to the server.
void	flush() Flushes buffer, if applicable
int	getFailureCount() Returns the number of failed writes to the server.
boolean	isConnected() Returns true if ready to send data
void	send(String name, double value) Send a measurement to Wavefront.
void	send(String name, double value, Long timestamp) Send a measurement to Wavefront.
void	send(String name, double value, Long timestamp, String source) Send a measurement to Wavefront.
void	send(String name, double value, Long timestamp, String source, Map<String,String> pointTags) Send the given measurement to the server.
void	send(String name, double value, String source, Map<String,String> pointTags) Send the given measurement to the server.

Methods inherited from interface java.io.Closeable

close

Method Detail

connect

void connect()
      throws IllegalStateException,
             IOException

Connects to the server.

Throws:

IllegalStateException - if the client is already connected

IOException - if there is an error connecting

send

void send(String name,
          double value)
   throws IOException

Send a measurement to Wavefront. The current machine's hostname would be used as the source. The point will be timestamped at the agent.

Parameters:

name - The name of the metric. Spaces are replaced with '-' (dashes) and quotes will be automatically escaped.

value - The value to be sent.

Throws:

IOException - Throws if there was an error sending the metric.

UnknownHostException - Throws if there's an error determining the current host.

send

void send(String name,
          double value,
          @Nullable
          Long timestamp)
   throws IOException

Send a measurement to Wavefront. The current machine's hostname would be used as the source.

Parameters:

name - The name of the metric. Spaces are replaced with '-' (dashes) and quotes will be automatically escaped.

value - The value to be sent.

timestamp - The timestamp in seconds since the epoch to be sent.

Throws:

IOException - Throws if there was an error sending the metric.

UnknownHostException - Throws if there's an error determining the current host.

send

void send(String name,
          double value,
          @Nullable
          Long timestamp,
          String source)
   throws IOException

Send a measurement to Wavefront.

Parameters:

name - The name of the metric. Spaces are replaced with '-' (dashes) and quotes will be automatically escaped.

value - The value to be sent.

timestamp - The timestamp in seconds since the epoch to be sent.

source - The source (or host) that's sending the metric.

Throws:

IOException - if there was an error sending the metric.

send

void send(String name,
          double value,
          String source,
          @Nullable
          Map<String,String> pointTags)
   throws IOException

Send the given measurement to the server.

Parameters:

name - The name of the metric. Spaces are replaced with '-' (dashes) and quotes will be automatically escaped.

value - The value to be sent.

source - The source (or host) that's sending the metric. Null to use machine hostname.

pointTags - The point tags associated with this measurement.

Throws:

IOException - if there was an error sending the metric.

send

void send(String name,
          double value,
          @Nullable
          Long timestamp,
          String source,
          @Nullable
          Map<String,String> pointTags)
   throws IOException

Send the given measurement to the server.

Parameters:

name - The name of the metric. Spaces are replaced with '-' (dashes) and quotes will be automatically escaped.

value - The value to be sent.

timestamp - The timestamp in seconds since the epoch to be sent. Null to use agent assigned timestamp.

source - The source (or host) that's sending the metric. Null to use machine hostname.

pointTags - The point tags associated with this measurement.

Throws:

IOException - if there was an error sending the metric.

flush

void flush()
    throws IOException

Flushes buffer, if applicable

Throws:

IOException

isConnected

boolean isConnected()

Returns true if ready to send data

getFailureCount

int getFailureCount()

Returns the number of failed writes to the server.

Returns:

the number of failed writes to the server