com.googlecode.jmxtrans.model.output

Class RRDToolWriter

java.lang.Object

com.googlecode.jmxtrans.model.output.BaseOutputWriter

com.googlecode.jmxtrans.model.output.RRDToolWriter

All Implemented Interfaces:

OutputWriter, OutputWriterFactory, AutoCloseable

public class RRDToolWriter
extends BaseOutputWriter

This takes a JRobin template.xml file and then creates the database if it doesn't already exist. It will then write the contents of the Query (the Results) to the database. This method exec's out to use the command line version of rrdtool. You need to specify the path to the directory where the binary rrdtool lives.

Author:

jon

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	RRDToolWriter.Builder

Field Summary

Fields

Modifier and Type	Field and Description
static String	GENERATE

Fields inherited from class com.googlecode.jmxtrans.model.output.BaseOutputWriter

BINARY_PATH, BOOLEAN_AS_NUMBER, DEBUG, HOST, OUTPUT_FILE, PORT, TEMPLATE_FILE, TYPE_NAMES

Constructor Summary

Constructors

Constructor and Description
RRDToolWriter(com.google.common.collect.ImmutableList<String> typeNames, boolean booleanAsNumber, Boolean debugEnabled, String outputFile, String templateFile, String binaryPath, Boolean generate, Map<String,Object> settings)

Method Summary

Modifier and Type	Method and Description
static RRDToolWriter.Builder	builder()
String	getBinaryPath()
protected org.jrobin.core.RrdDef	getDatabaseTemplateSpec() If the database file doesn't exist, it'll get created, otherwise, it'll be returned in r/w mode.
String	getDataSourceName(String typeName, String attributeName, String entry) rrd datasources must be less than 21 characters in length, so work to make it shorter.
String	getOutputFile()
String	getTemplateFile()
void	internalWrite(Server server, Query query, com.google.common.collect.ImmutableList<Result> results)
protected void	rrdToolCreateDatabase(org.jrobin.core.RrdDef def) Calls out to the rrdtool binary with the 'create' command.
protected void	rrdToolUpdate(String template, String data) Executes the rrdtool update command.
void	validateSetup(Server server, Query query)

Methods inherited from class com.googlecode.jmxtrans.model.output.BaseOutputWriter

close, create, doWrite, firstNonNull, getConcatedTypeNameValues, getSettings, getTypeNames, isDebugEnabled, start, toString

Methods inherited from class java.lang.Object

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

Field Detail

GENERATE

public static final String GENERATE

See Also:

Constant Field Values

Constructor Detail

RRDToolWriter

public RRDToolWriter(com.google.common.collect.ImmutableList<String> typeNames,
                     boolean booleanAsNumber,
                     Boolean debugEnabled,
                     String outputFile,
                     String templateFile,
                     String binaryPath,
                     Boolean generate,
                     Map<String,Object> settings)

Method Detail

validateSetup

public void validateSetup(Server server,
                          Query query)
                   throws ValidationException

Throws:

ValidationException

getDataSourceName

public String getDataSourceName(String typeName,
                                String attributeName,
                                String entry)

rrd datasources must be less than 21 characters in length, so work to make it shorter. Not ideal at all, but works fairly well it seems.

internalWrite

public void internalWrite(Server server,
                          Query query,
                          com.google.common.collect.ImmutableList<Result> results)
                   throws Exception

Specified by:

internalWrite in class BaseOutputWriter

Throws:

Exception

rrdToolUpdate

protected void rrdToolUpdate(String template,
                             String data)
                      throws Exception

Executes the rrdtool update command.

Throws:

Exception

getDatabaseTemplateSpec

protected org.jrobin.core.RrdDef getDatabaseTemplateSpec()
                                                  throws Exception

If the database file doesn't exist, it'll get created, otherwise, it'll be returned in r/w mode.

Throws:

Exception

rrdToolCreateDatabase

protected void rrdToolCreateDatabase(org.jrobin.core.RrdDef def)
                              throws Exception

Calls out to the rrdtool binary with the 'create' command.

Throws:

Exception

getOutputFile

public String getOutputFile()

getTemplateFile

public String getTemplateFile()

getBinaryPath

public String getBinaryPath()

builder

public static RRDToolWriter.Builder builder()