biz.paluch.logging.gelf.log4j

Class GelfLogAppender

java.lang.Object

org.apache.log4j.AppenderSkeleton

biz.paluch.logging.gelf.log4j.GelfLogAppender

All Implemented Interfaces:

ErrorReporter, org.apache.log4j.Appender, org.apache.log4j.spi.OptionHandler

public class GelfLogAppender
extends org.apache.log4j.AppenderSkeleton
implements ErrorReporter

Logging-Handler for GELF (Graylog Extended Logging Format). This Java-Util-Logging Handler creates GELF Messages and posts them using UDP (default) or TCP. Following parameters are supported/needed:

• host (Mandatory): Hostname/IP-Address of the Logstash Host
  • tcp:(the host) for TCP, e.g. tcp:127.0.0.1 or tcp:some.host.com
  • udp:(the host) for UDP, e.g. udp:127.0.0.1 or udp:some.host.com
  • (the host) for UDP, e.g. 127.0.0.1 or some.host.com
• port (Optional): Port, default 12201
• originHost (Optional): Originating Hostname, default FQDN Hostname
• extractStackTrace (Optional): Post Stack-Trace to StackTrace field, default false
• filterStackTrace (Optional): Perform Stack-Trace filtering (true/false), default false
• mdcProfiling (Optional): Perform Profiling (Call-Duration) based on MDC Data. See MDC Profiling, default false
• facility (Optional): Name of the Facility, default gelf-java
• threshold (Optional): Log-Level, default INFO
• filter (Optional): Class-Name of a Log-Filter, default none
• additionalFields(number) (Optional): Post additional fields. Eg. .GelfLogHandler.additionalFields=fieldName=Value,field2=value2
• mdcFields (Optional): Post additional fields, pull Values from MDC. Name of the Fields are comma-separated mdcFields=Application,Version,SomeOtherFieldName
• dynamicMdcFields (Optional): Dynamic MDC Fields allows you to extract MDC values based on one or more regular expressions. Multiple regex are comma-separated. The name of the MDC entry is used as GELF field name.
• includeFullMdc (Optional): Include all fields from the MDC, default false

MDC Profiling

MDC Profiling allows to calculate the runtime from request start up to the time until the log message was generated. You must set one value in the MDC:

• profiling.requestStart.millis: Time Millis of the Request-Start (Long or String)

Two values are set by the Log Appender:

• profiling.requestEnd: End-Time of the Request-End in Date.toString-representation
• profiling.requestDuration: Duration of the request (e.g. 205ms, 16sec)

Field Summary

Fields

Modifier and Type	Field and Description
protected MdcGelfMessageAssembler	gelfMessageAssembler
protected GelfSender	gelfSender

Fields inherited from class org.apache.log4j.AppenderSkeleton

closed, errorHandler, headFilter, layout, name, tailFilter, threshold

Constructor Summary

Constructors

Constructor and Description
GelfLogAppender()

Method Summary

Methods

Modifier and Type	Method and Description
protected void	append(org.apache.log4j.spi.LoggingEvent event)
void	close()
protected GelfMessage	createGelfMessage(org.apache.log4j.spi.LoggingEvent loggingEvent)
String	getFacility()
String	getGraylogHost()
int	getGraylogPort()
String	getHost()
int	getMaximumMessageSize()
String	getOriginHost()
int	getPort()
String	getTimestampPattern()
boolean	isExtractStackTrace()
boolean	isFilterStackTrace()
boolean	isIncludeFullMdc()
boolean	isMdcProfiling()
void	reportError(String message, Exception exception) Report an error caused by a exception.
boolean	requiresLayout()
void	setAdditionalFields(String fieldSpec)
void	setDynamicMdcFields(String fieldSpec)
void	setExtractStackTrace(boolean extractStacktrace)
void	setFacility(String facility)
void	setFilterStackTrace(boolean filterStackTrace)
void	setGraylogHost(String graylogHost)
void	setGraylogPort(int graylogPort)
void	setHost(String host)
void	setIncludeFullMdc(boolean includeFullMdc)
void	setMaximumMessageSize(int maximumMessageSize)
void	setMdcFields(String fieldSpec)
void	setMdcProfiling(boolean mdcProfiling)
void	setOriginHost(String originHost)
void	setPort(int port)
void	setTimestampPattern(String timestampPattern)

Methods inherited from class org.apache.log4j.AppenderSkeleton

activateOptions, addFilter, clearFilters, doAppend, finalize, getErrorHandler, getFilter, getFirstFilter, getLayout, getName, getThreshold, isAsSevereAsThreshold, setErrorHandler, setLayout, setName, setThreshold

Methods inherited from class java.lang.Object

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

Field Detail

gelfSender

protected GelfSender gelfSender

gelfMessageAssembler

protected MdcGelfMessageAssembler gelfMessageAssembler

Constructor Detail

GelfLogAppender

public GelfLogAppender()

Method Detail

append

protected void append(org.apache.log4j.spi.LoggingEvent event)

Specified by:

append in class org.apache.log4j.AppenderSkeleton

reportError

public void reportError(String message,
               Exception exception)

Description copied from interface: ErrorReporter

Report an error caused by a exception.

Specified by:

reportError in interface ErrorReporter

requiresLayout

public boolean requiresLayout()

Specified by:

requiresLayout in interface org.apache.log4j.Appender

Specified by:

requiresLayout in class org.apache.log4j.AppenderSkeleton

close

public void close()

Specified by:

close in interface org.apache.log4j.Appender

Specified by:

close in class org.apache.log4j.AppenderSkeleton

createGelfMessage

protected GelfMessage createGelfMessage(org.apache.log4j.spi.LoggingEvent loggingEvent)

setAdditionalFields

public void setAdditionalFields(String fieldSpec)

setMdcFields

public void setMdcFields(String fieldSpec)

getGraylogHost

public String getGraylogHost()

setGraylogHost

public void setGraylogHost(String graylogHost)

getGraylogPort

public int getGraylogPort()

setGraylogPort

public void setGraylogPort(int graylogPort)

getHost

public String getHost()

setHost

public void setHost(String host)

getPort

public int getPort()

setPort

public void setPort(int port)

getOriginHost

public String getOriginHost()

setOriginHost

public void setOriginHost(String originHost)

getFacility

public String getFacility()

setFacility

public void setFacility(String facility)

isExtractStackTrace

public boolean isExtractStackTrace()

setExtractStackTrace

public void setExtractStackTrace(boolean extractStacktrace)

isFilterStackTrace

public boolean isFilterStackTrace()

setFilterStackTrace

public void setFilterStackTrace(boolean filterStackTrace)

isMdcProfiling

public boolean isMdcProfiling()

setMdcProfiling

public void setMdcProfiling(boolean mdcProfiling)

getTimestampPattern

public String getTimestampPattern()

setTimestampPattern

public void setTimestampPattern(String timestampPattern)

getMaximumMessageSize

public int getMaximumMessageSize()

setMaximumMessageSize

public void setMaximumMessageSize(int maximumMessageSize)

setDynamicMdcFields

public void setDynamicMdcFields(String fieldSpec)

isIncludeFullMdc

public boolean isIncludeFullMdc()

setIncludeFullMdc

public void setIncludeFullMdc(boolean includeFullMdc)