com.wavefront.integrations

Class Wavefront

java.lang.Object

com.wavefront.integrations.AbstractProxyConnectionHandler

com.wavefront.integrations.Wavefront

All Implemented Interfaces:

WavefrontConnectionHandler, WavefrontSender, Closeable, AutoCloseable

public class Wavefront
extends AbstractProxyConnectionHandler
implements WavefrontSender

Wavefront Client that sends data directly via TCP to the Wavefront Proxy Agent. User should probably attempt to reconnect when exceptions are thrown from any methods.

Author:

Clement Pang (clement@wavefront.com)., Conor Beverland (conor@wavefront.com).

Constructor Summary

Constructors

Constructor and Description
Wavefront(InetSocketAddress agentAddress) Creates a new client which connects to the given address using the default SocketFactory.
Wavefront(InetSocketAddress agentAddress, SocketFactory socketFactory) Creates a new client which connects to the given address and socket factory using the given character set.
Wavefront(InetSocketAddress agentAddress, SocketFactory socketFactory, Long connectionTimeToLiveMillis, java.util.function.Supplier<Long> timeSupplier) Creates a new client which connects to the given address and socket factory and enforces connection TTL limit
Wavefront(String agentHostName, int port) Creates a new client which connects to the given address using the default SocketFactory.
Wavefront(String agentHostName, int port, SocketFactory socketFactory) Creates a new client which connects to the given address and socket factory.

Method Summary

Modifier and Type	Method and Description
int	getFailureCount() Returns the number of failed writes to the server.
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 class com.wavefront.integrations.AbstractProxyConnectionHandler

close, connect, flush, isConnected, sendData

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.wavefront.integrations.WavefrontConnectionHandler

connect, flush, isConnected

Methods inherited from interface java.io.Closeable

close

Constructor Detail

Wavefront

public Wavefront(String agentHostName,
                 int port)

Creates a new client which connects to the given address using the default SocketFactory.

Parameters:

agentHostName - The hostname of the Wavefront Proxy Agent

port - The port of the Wavefront Proxy Agent

Wavefront

public Wavefront(String agentHostName,
                 int port,
                 SocketFactory socketFactory)

Creates a new client which connects to the given address and socket factory.

Parameters:

agentHostName - The hostname of the Wavefront Proxy Agent

port - The port of the Wavefront Proxy Agent

socketFactory - the socket factory

Wavefront

public Wavefront(InetSocketAddress agentAddress)

Creates a new client which connects to the given address using the default SocketFactory.

Parameters:

agentAddress - the address of the Wavefront Proxy Agent

Wavefront

public Wavefront(InetSocketAddress agentAddress,
                 SocketFactory socketFactory)

Creates a new client which connects to the given address and socket factory using the given character set.

Parameters:

agentAddress - the address of the Wavefront Proxy Agent

socketFactory - the socket factory

Wavefront

public Wavefront(InetSocketAddress agentAddress,
                 SocketFactory socketFactory,
                 @Nullable
                 Long connectionTimeToLiveMillis,
                 @Nullable
                 java.util.function.Supplier<Long> timeSupplier)

Creates a new client which connects to the given address and socket factory and enforces connection TTL limit

Parameters:

agentAddress - the address of the Wavefront Proxy Agent

socketFactory - the socket factory

connectionTimeToLiveMillis - Connection TTL, with expiration checked after each flush. When null, TTL is not enforced.

timeSupplier - Get current timestamp in millis

Method Detail

send

public void send(String name,
                 double value)
          throws IOException

Description copied from interface: WavefrontSender

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

Specified by:

send in interface WavefrontSender

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

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

Description copied from interface: WavefrontSender

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

Specified by:

send in interface WavefrontSender

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

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

Description copied from interface: WavefrontSender

Send a measurement to Wavefront.

Specified by:

send in interface WavefrontSender

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

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

Description copied from interface: WavefrontSender

Send the given measurement to the server.

Specified by:

send in interface WavefrontSender

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

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

Description copied from interface: WavefrontSender

Send the given measurement to the server.

Specified by:

send in interface WavefrontSender

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.

getFailureCount

public int getFailureCount()

Description copied from interface: WavefrontConnectionHandler

Returns the number of failed writes to the server.

Specified by:

getFailureCount in interface WavefrontConnectionHandler

Returns:

the number of failed writes to the server