com.codahale.metrics.graphite

Class GraphiteUDP

java.lang.Object

com.codahale.metrics.graphite.GraphiteUDP

All Implemented Interfaces:

GraphiteSender, Closeable, AutoCloseable

public class GraphiteUDP
extends Object
implements GraphiteSender

A client to a Carbon server using unconnected UDP

Constructor Summary

Constructors

Constructor and Description
GraphiteUDP(InetSocketAddress address) Creates a new client which sends data to given address using UDP
GraphiteUDP(String hostname, int port) Creates a new client which sends data to given address using UDP

Method Summary

Modifier and Type	Method and Description
void	close()
void	connect() Connects to the server.
void	flush() Flushes buffer, if applicable
int	getFailures() Returns the number of failed writes to the server.
boolean	isConnected() Returns true if ready to send data
protected String	sanitize(String s)
void	send(String name, String value, long timestamp) Sends the given measurement to the server.

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphiteUDP

public GraphiteUDP(String hostname,
                   int port)

Creates a new client which sends data to given address using UDP

Parameters:

hostname - The hostname of the Carbon server

port - The port of the Carbon server

GraphiteUDP

public GraphiteUDP(InetSocketAddress address)

Creates a new client which sends data to given address using UDP

Parameters:

address - the address of the Carbon server

Method Detail

connect

public void connect()
             throws IllegalStateException,
                    IOException

Description copied from interface: GraphiteSender

Connects to the server.

Specified by:

connect in interface GraphiteSender

Throws:

IllegalStateException - if the client is already connected

IOException - if there is an error connecting

isConnected

public boolean isConnected()

Description copied from interface: GraphiteSender

Returns true if ready to send data

Specified by:

isConnected in interface GraphiteSender

send

public void send(String name,
                 String value,
                 long timestamp)
          throws IOException

Description copied from interface: GraphiteSender

Sends the given measurement to the server.

Specified by:

send in interface GraphiteSender

Parameters:

name - the name of the metric

value - the value of the metric

timestamp - the timestamp of the metric

Throws:

IOException - if there was an error sending the metric

getFailures

public int getFailures()

Description copied from interface: GraphiteSender

Returns the number of failed writes to the server.

Specified by:

getFailures in interface GraphiteSender

Returns:

the number of failed writes to the server

flush

public void flush()
           throws IOException

Description copied from interface: GraphiteSender

Flushes buffer, if applicable

Specified by:

flush in interface GraphiteSender

Throws:

IOException - if there was an error during flushing metrics to the socket

close

public void close()
           throws IOException

Specified by:

close in interface Closeable

Specified by:

close in interface AutoCloseable

Throws:

IOException

sanitize

protected String sanitize(String s)