org.jmxtrans.embedded.output

Class GraphitePickleWriter

java.lang.Object

org.jmxtrans.embedded.output.AbstractOutputWriter

org.jmxtrans.embedded.output.GraphitePickleWriter

All Implemented Interfaces:

OutputWriter

public class GraphitePickleWriter
extends AbstractOutputWriter
implements OutputWriter

Graphite implementation of the OutputWriter.

This implementation uses Carbon Pickle protocol over TCP/IP.

Settings:

• "host": hostname or ip address of the Graphite server. Mandatory
• "port": listen port for the TCP Plain Text Protocol of the Graphite server. Optional, default value: 2004.
• "namePrefix": prefix append to the metrics name. Optional, default value: "servers.#hostname#.".
• "enabled": flag to enable/disable the writer. Optional, default value: true.
• "graphite.socketConnectTimeoutInMillis": timeout for the socketConnect in millis. Optional, default value SocketOutputStreamPoolFactory.DEFAULT_SOCKET_CONNECT_TIMEOUT_IN_MILLIS

All the results of write(Iterable) are sent in one single cPickle message.

Author:

Cyrille Le Clerc

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_GRAPHITE_SERVER_PORT
static String	DEFAULT_NAME_PREFIX

Fields inherited from class org.jmxtrans.embedded.output.AbstractOutputWriter

SETTING_HOST, SETTING_NAME_PREFIX, SETTING_PORT, SETTING_PROXY_HOST, SETTING_PROXY_PORT, SETTING_TOKEN, SETTING_URL, SETTING_USERNAME

Constructor Summary

Constructors

Constructor and Description
GraphitePickleWriter()

Method Summary

Methods

Modifier and Type	Method and Description
void	start() Load settings, initialize the SocketWriter pool and test the connection to the graphite server.
void	stop() Close the SocketWriter pool.
void	write(Iterable<QueryResult> results) Send given metrics to the Graphite server.

Methods inherited from class org.jmxtrans.embedded.output.AbstractOutputWriter

equals, getBooleanSetting, getIntSetting, getIntSetting, getLongSetting, getSettings, getStrategy, getStringSetting, getStringSetting, hashCode, isEnabled, setEnabled, setSettings, setStrategy, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.jmxtrans.embedded.output.OutputWriter

getSettings, isEnabled, setEnabled, setSettings

Field Detail

DEFAULT_GRAPHITE_SERVER_PORT

public static final int DEFAULT_GRAPHITE_SERVER_PORT

See Also:

Constant Field Values

DEFAULT_NAME_PREFIX

public static final String DEFAULT_NAME_PREFIX

See Also:

Constant Field Values

Constructor Detail

GraphitePickleWriter

public GraphitePickleWriter()

Method Detail

start

public void start()

Load settings, initialize the SocketWriter pool and test the connection to the graphite server.

a Logger.warn(String) message is emitted if the connection to the graphite server fails.

Specified by:

start in interface OutputWriter

Overrides:

start in class AbstractOutputWriter

write

public void write(Iterable<QueryResult> results)

Send given metrics to the Graphite server.

Specified by:

write in interface OutputWriter

Specified by:

write in class AbstractOutputWriter

stop

public void stop()
          throws Exception

Close the SocketWriter pool.

Specified by:

stop in interface OutputWriter

Overrides:

stop in class AbstractOutputWriter

Throws:

Exception