org.graylog2.log4j2

Class GelfAppender

java.lang.Object

org.apache.logging.log4j.core.AbstractLifeCycle

org.apache.logging.log4j.core.filter.AbstractFilterable

org.apache.logging.log4j.core.appender.AbstractAppender

org.graylog2.log4j2.GelfAppender

All Implemented Interfaces:

java.io.Serializable, org.apache.logging.log4j.core.Appender, org.apache.logging.log4j.core.filter.Filterable, org.apache.logging.log4j.core.LifeCycle

@Plugin(name="GELF",
        category="Core",
        elementType="appender",
        printObject=true)
public class GelfAppender
extends org.apache.logging.log4j.core.appender.AbstractAppender

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface org.apache.logging.log4j.core.LifeCycle

org.apache.logging.log4j.core.LifeCycle.State

Field Summary

Fields inherited from class org.apache.logging.log4j.core.AbstractLifeCycle

LOGGER

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GelfAppender(java.lang.String name, org.apache.logging.log4j.core.Layout<? extends java.io.Serializable> layout, org.apache.logging.log4j.core.Filter filter, boolean ignoreExceptions, org.graylog2.gelfclient.GelfConfiguration gelfConfiguration, java.lang.String hostName, boolean includeSource, boolean includeThreadContext, boolean includeStackTrace, java.lang.String additionalFields)

Method Summary

Modifier and Type	Method and Description
void	append(org.apache.logging.log4j.core.LogEvent event)
static GelfAppender	createGelfAppender(org.apache.logging.log4j.core.Filter filter, org.apache.logging.log4j.core.Layout<? extends java.io.Serializable> layout, java.lang.String name, java.lang.Boolean ignoreExceptions, java.lang.String server, java.lang.Integer port, java.lang.String protocol, java.lang.String hostName, java.lang.Integer queueSize, java.lang.Integer connectTimeout, java.lang.Integer reconnectDelay, java.lang.Integer sendBufferSize, java.lang.Boolean tcpNoDelay, java.lang.Boolean includeSource, java.lang.Boolean includeThreadContext, java.lang.Boolean includeStackTrace, java.lang.String additionalFields) Factory method for creating a GelfTransport provider within the plugin manager.
void	start()
void	stop()
java.lang.String	toString()

Methods inherited from class org.apache.logging.log4j.core.appender.AbstractAppender

error, error, error, getHandler, getLayout, getName, ignoreExceptions, parseInt, setHandler

Methods inherited from class org.apache.logging.log4j.core.filter.AbstractFilterable

addFilter, getFilter, hasFilter, isFiltered, removeFilter

Methods inherited from class org.apache.logging.log4j.core.AbstractLifeCycle

equals, getState, hashCode, isInitialized, isStarted, isStarting, isStopped, isStopping, setStarted, setStarting, setState, setStopped, setStopping

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.logging.log4j.core.LifeCycle

isStarted, isStopped

Constructor Detail

GelfAppender

protected GelfAppender(java.lang.String name,
                       org.apache.logging.log4j.core.Layout<? extends java.io.Serializable> layout,
                       org.apache.logging.log4j.core.Filter filter,
                       boolean ignoreExceptions,
                       org.graylog2.gelfclient.GelfConfiguration gelfConfiguration,
                       java.lang.String hostName,
                       boolean includeSource,
                       boolean includeThreadContext,
                       boolean includeStackTrace,
                       java.lang.String additionalFields)

Method Detail

append

public void append(org.apache.logging.log4j.core.LogEvent event)

start

public void start()

Specified by:

start in interface org.apache.logging.log4j.core.LifeCycle

Overrides:

start in class org.apache.logging.log4j.core.filter.AbstractFilterable

stop

public void stop()

Specified by:

stop in interface org.apache.logging.log4j.core.LifeCycle

Overrides:

stop in class org.apache.logging.log4j.core.filter.AbstractFilterable

toString

public java.lang.String toString()

Overrides:

toString in class org.apache.logging.log4j.core.appender.AbstractAppender

createGelfAppender

@PluginFactory
public static GelfAppender createGelfAppender(@PluginElement(value="Filter")
                                                             org.apache.logging.log4j.core.Filter filter,
                                                             @PluginElement(value="Layout")
                                                             org.apache.logging.log4j.core.Layout<? extends java.io.Serializable> layout,
                                                             @PluginAttribute(value="name")
                                                             java.lang.String name,
                                                             @PluginAttribute(value="ignoreExceptions",defaultBoolean=true)
                                                             java.lang.Boolean ignoreExceptions,
                                                             @PluginAttribute(value="server",defaultString="localhost")
                                                             java.lang.String server,
                                                             @PluginAttribute(value="port",defaultInt=12201)
                                                             java.lang.Integer port,
                                                             @PluginAttribute(value="protocol",defaultString="UDP")
                                                             java.lang.String protocol,
                                                             @PluginAttribute(value="hostName")
                                                             java.lang.String hostName,
                                                             @PluginAttribute(value="queueSize",defaultInt=512)
                                                             java.lang.Integer queueSize,
                                                             @PluginAttribute(value="connectTimeout",defaultInt=1000)
                                                             java.lang.Integer connectTimeout,
                                                             @PluginAttribute(value="reconnectDelay",defaultInt=500)
                                                             java.lang.Integer reconnectDelay,
                                                             @PluginAttribute(value="sendBufferSize",defaultInt=-1)
                                                             java.lang.Integer sendBufferSize,
                                                             @PluginAttribute(value="tcpNoDelay",defaultBoolean=false)
                                                             java.lang.Boolean tcpNoDelay,
                                                             @PluginAttribute(value="includeSource",defaultBoolean=true)
                                                             java.lang.Boolean includeSource,
                                                             @PluginAttribute(value="includeThreadContext",defaultBoolean=true)
                                                             java.lang.Boolean includeThreadContext,
                                                             @PluginAttribute(value="includeStackTrace",defaultBoolean=true)
                                                             java.lang.Boolean includeStackTrace,
                                                             @PluginAttribute(value="additionalFields")
                                                             java.lang.String additionalFields)

Factory method for creating a GelfTransport provider within the plugin manager.

Parameters:

name - The name of the Appender.

filter - A Filter to determine if the event should be handled by this Appender.

layout - The Layout to use to format the LogEvent defaults to "%m%n".

ignoreExceptions - The default is true, causing exceptions encountered while appending events to be internally logged and then ignored. When set to false exceptions will be propagated to the caller, instead. Must be set to false when wrapping this Appender in a FailoverAppender.

server - The server name of the GELF server, defaults to localhost.

port - The port the GELF server is listening on, defaults to 12201.

hostName - The host name of the machine generating the logs, defaults to local host name or localhost if it couldn't be detected.

protocol - The transport protocol to use, defaults to UDP.

queueSize - The size of the internally used queue, defaults to 512.

connectTimeout - The connection timeout for TCP connections in milliseconds, defaults to 1000.

reconnectDelay - The time to wait between reconnects in milliseconds, defaults to 500.

sendBufferSize - The size of the socket send buffer in bytes, defaults to -1 (deactivate).

tcpNoDelay - Whether Nagle's algorithm should be used for TCP connections, defaults to false.

includeSource - Whether the source of the log message should be included, defaults to true.

includeThreadContext - Whether the contents of the ThreadContext should be included, defaults to true.

includeStackTrace - Whether a full stack trace should be included, defaults to true.

additionalFields - Additional static comma-delimited key=value pairs that will be added to every log message.

Returns:

a new GELF provider