net.kencochrane.raven.logback

Class SentryAppender

java.lang.Object

ch.qos.logback.core.spi.ContextAwareBase

ch.qos.logback.core.AppenderBase<ch.qos.logback.classic.spi.ILoggingEvent>

net.kencochrane.raven.logback.SentryAppender

All Implemented Interfaces:

ch.qos.logback.core.Appender<ch.qos.logback.classic.spi.ILoggingEvent>, ch.qos.logback.core.spi.ContextAware, ch.qos.logback.core.spi.FilterAttachable<ch.qos.logback.classic.spi.ILoggingEvent>, ch.qos.logback.core.spi.LifeCycle

public class SentryAppender
extends ch.qos.logback.core.AppenderBase<ch.qos.logback.classic.spi.ILoggingEvent>

Appender for logback in charge of sending the logged events to a Sentry server.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	dsn DSN property of the appender.
static String	LOGBACK_MARKER Name of the Event.extra property containing Maker details.
protected Raven	raven Current instance of Raven.
protected String	ravenFactory Name of the RavenFactory being used.
static String	THREAD_NAME Name of the Event.extra property containing the Thread name.

Fields inherited from class ch.qos.logback.core.AppenderBase

name, started

Fields inherited from class ch.qos.logback.core.spi.ContextAwareBase

context

Constructor Summary

Constructors

Constructor and Description
SentryAppender() Creates an instance of SentryAppender.
SentryAppender(Raven raven) Creates an instance of SentryAppender.
SentryAppender(Raven raven, boolean propagateClose) Creates an instance of SentryAppender.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	append(ch.qos.logback.classic.spi.ILoggingEvent iLoggingEvent)
protected Event	buildEvent(ch.qos.logback.classic.spi.ILoggingEvent iLoggingEvent) Builds an Event based on the logging event.
protected String	buildStackTrace(Throwable e) Builds a String version of the stacktrace including the stacktrace of the causes.
protected static Event.Level	formatLevel(ch.qos.logback.classic.Level level) Transforms a Level into an Event.Level.
protected static List<String>	formatMessageParameters(Object[] parameters) Extracts message parameters into a List of Strings.
protected void	initRaven() Initialises the Raven instance.
void	setDsn(String dsn)
void	setRavenFactory(String ravenFactory)
void	stop()

Methods inherited from class ch.qos.logback.core.AppenderBase

addFilter, clearAllFilters, doAppend, getCopyOfAttachedFiltersList, getFilterChainDecision, getName, isStarted, setName, start, toString

Methods inherited from class ch.qos.logback.core.spi.ContextAwareBase

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, getDeclaredOrigin, getStatusManager, setContext

Methods inherited from class java.lang.Object

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

Methods inherited from interface ch.qos.logback.core.spi.ContextAware

addError, addError, addInfo, addInfo, addStatus, addWarn, addWarn, getContext, setContext

Field Detail

LOGBACK_MARKER

public static final String LOGBACK_MARKER

Name of the Event.extra property containing Maker details.

See Also:

Constant Field Values

THREAD_NAME

public static final String THREAD_NAME

Name of the Event.extra property containing the Thread name.

See Also:

Constant Field Values

raven

protected Raven raven

Current instance of Raven.

See Also:

initRaven()

dsn

protected String dsn

DSN property of the appender.

Might be null in which case the DSN should be detected automatically.

ravenFactory

protected String ravenFactory

Name of the RavenFactory being used.

Might be null in which case the factory should be defined automatically.

Constructor Detail

SentryAppender

public SentryAppender()

Creates an instance of SentryAppender.

SentryAppender

public SentryAppender(Raven raven)

Creates an instance of SentryAppender.

Parameters:

raven - instance of Raven to use with this appender.

SentryAppender

public SentryAppender(Raven raven,
              boolean propagateClose)

Creates an instance of SentryAppender.

Parameters:

raven - instance of Raven to use with this appender.

propagateClose - true if the Closeable.close() should be called when the appender is closed.

Method Detail

formatMessageParameters

protected static List<String> formatMessageParameters(Object[] parameters)

Extracts message parameters into a List of Strings.

null parameters are kept as null.

Parameters:

parameters - parameters provided to the logging system.

Returns:

the parameters formatted as Strings in a List.

formatLevel

protected static Event.Level formatLevel(ch.qos.logback.classic.Level level)

Transforms a Level into an Event.Level.

Parameters:

level - original level as defined in logback.

Returns:

log level used within raven.

append

protected void append(ch.qos.logback.classic.spi.ILoggingEvent iLoggingEvent)

The raven instance is started in this method instead of AppenderBase.start() in order to avoid substitute loggers being generated during the instantiation of Raven.
More on www.slf4j.org/codes.html#substituteLogger

Specified by:

append in class ch.qos.logback.core.AppenderBase<ch.qos.logback.classic.spi.ILoggingEvent>

initRaven

protected void initRaven()

Initialises the Raven instance.

buildEvent

protected Event buildEvent(ch.qos.logback.classic.spi.ILoggingEvent iLoggingEvent)

Builds an Event based on the logging event.

Parameters:

iLoggingEvent - Log generated.

Returns:

Event containing details provided by the logging system.

buildStackTrace

protected String buildStackTrace(Throwable e)

Builds a String version of the stacktrace including the stacktrace of the causes.

Parameters:

e - exception from which the stacktrace should be extracted.

Returns:

a String version of the stacktrace.

setDsn

public void setDsn(String dsn)

setRavenFactory

public void setRavenFactory(String ravenFactory)

stop

public void stop()

Specified by:

stop in interface ch.qos.logback.core.spi.LifeCycle

Overrides:

stop in class ch.qos.logback.core.AppenderBase<ch.qos.logback.classic.spi.ILoggingEvent>