com.googlecode.jmxtrans.model.output

Class NagiosWriter

java.lang.Object

com.googlecode.jmxtrans.model.output.BaseOutputWriter

com.googlecode.jmxtrans.model.output.NagiosWriter

All Implemented Interfaces:

OutputWriter, OutputWriterFactory, AutoCloseable

public class NagiosWriter
extends BaseOutputWriter

Writes out data in Nagios format to a file, it should be used with Nagios external command file.

Author:

Denis "Thuck" Doria

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	LOG_IO_BUFFER_SIZE_BYTES
protected static String	LOG_PATTERN
protected org.apache.log4j.Logger	logger
protected Map<String,org.apache.log4j.Logger>	loggers

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
NagiosWriter(com.google.common.collect.ImmutableList<String> typeNames, boolean booleanAsNumber, Boolean debugEnabled, List<String> filters, List<String> thresholds, String nagiosHost, String outputFile, String prefix, String suffix, Map<String,Object> settings)

Method Summary

Modifier and Type	Method and Description
void	checkFile(Query query) Creates the logging.
com.google.common.collect.ImmutableList<String>	getFilters()
String	getNagiosHost()
String	getOutputFile()
String	getPrefix()
String	getSuffix()
com.google.common.collect.ImmutableList<String>	getThresholds()
protected org.apache.log4j.Logger	initLogger(String fileStr) Initializes the logger.
void	internalWrite(Server server, Query query, com.google.common.collect.ImmutableList<Result> results) The meat of the output.
protected String	nagiosCheckValue(String value, String composeRange) Define if a value is in a critical, warning or ok state.
void	validateSetup(Server server, Query query) Initial log setup.
protected boolean	valueCheck(double value, String simpleRange) Check if a value is inside of a range defined in the thresholds.

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

LOG_PATTERN

protected static final String LOG_PATTERN

See Also:

Constant Field Values

LOG_IO_BUFFER_SIZE_BYTES

protected static final int LOG_IO_BUFFER_SIZE_BYTES

See Also:

Constant Field Values

loggers

protected final Map<String,org.apache.log4j.Logger> loggers

logger

protected org.apache.log4j.Logger logger

Constructor Detail

NagiosWriter

public NagiosWriter(com.google.common.collect.ImmutableList<String> typeNames,
                    boolean booleanAsNumber,
                    Boolean debugEnabled,
                    List<String> filters,
                    List<String> thresholds,
                    String nagiosHost,
                    String outputFile,
                    String prefix,
                    String suffix,
                    Map<String,Object> settings)

Method Detail

validateSetup

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

Initial log setup.

Throws:

ValidationException

checkFile

public void checkFile(Query query)
               throws ValidationException

Creates the logging. Nagios doesn't start if the external command pipe exists, so we write to /dev/null until we have it available. From the official documentation:

The external command file is implemented as a named pipe (FIFO), which is created when Nagios starts and removed when it shuts down. If the file exists when Nagios starts, the Nagios process will terminate with an error message. http://nagios.sourceforge.net/docs/3_0/configmain.html#command_file

Throws:

ValidationException

internalWrite

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

The meat of the output. Nagios format..

Specified by:

internalWrite in class BaseOutputWriter

Throws:

Exception

initLogger

protected org.apache.log4j.Logger initLogger(String fileStr)
                                      throws IOException

Initializes the logger. This is called when we need to create a new logger for the given file name.

Parameters:

fileStr -

Returns:

a new Logger instance for the given fileStr

Throws:

IOException

nagiosCheckValue

protected String nagiosCheckValue(String value,
                                  String composeRange)

Define if a value is in a critical, warning or ok state.

valueCheck

protected boolean valueCheck(double value,
                             String simpleRange)

Check if a value is inside of a range defined in the thresholds. This check is based on Nagios range definition. http://nagiosplug.sourceforge.net/developer-guidelines.html#THRESHOLDFORMAT

getFilters

public com.google.common.collect.ImmutableList<String> getFilters()

getThresholds

public com.google.common.collect.ImmutableList<String> getThresholds()

getNagiosHost

public String getNagiosHost()

getOutputFile

public String getOutputFile()

getPrefix

public String getPrefix()

getSuffix

public String getSuffix()