net.kencochrane.raven.jul

Class SentryHandler

java.lang.Object

java.util.logging.Handler

net.kencochrane.raven.jul.SentryHandler

public class SentryHandler
extends Handler

Logging handler in charge of sending the java.util.logging records to a Sentry server.

Field Summary

Fields

Modifier and Type	Field and Description
protected String	dsn DSN property of the appender.
protected Raven	raven Current instance of Raven.
protected String	ravenFactory Name of the RavenFactory being used.
protected Map<String,String>	tags Tags to add to every event.
static String	THREAD_ID Name of the Event.extra property containing the Thread id.

Constructor Summary

Constructors

Constructor and Description
SentryHandler() Creates an instance of SentryHandler.
SentryHandler(Raven raven) Creates an instance of SentryHandler.

Method Summary

Methods

Modifier and Type	Method and Description
protected Event	buildEvent(LogRecord record) Builds an Event based on the log record.
void	close()
void	flush()
protected static List<String>	formatMessageParameters(Object[] parameters) Extracts message parameters into a List of Strings.
protected static Event.Level	getLevel(Level level) Transforms a Level into an Event.Level.
protected void	initRaven() Initialises the Raven instance.
void	publish(LogRecord record)
protected void	retrieveProperties() Retrieves the properties of the logger.

Methods inherited from class java.util.logging.Handler

getEncoding, getErrorManager, getFilter, getFormatter, getLevel, isLoggable, reportError, setEncoding, setErrorManager, setFilter, setFormatter, setLevel

Methods inherited from class java.lang.Object

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

Field Detail

THREAD_ID

public static final String THREAD_ID

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

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.

tags

protected Map<String,String> tags

Tags to add to every event.

Constructor Detail

SentryHandler

public SentryHandler()

Creates an instance of SentryHandler.

SentryHandler

public SentryHandler(Raven raven)

Creates an instance of SentryHandler.

Parameters:

raven - instance of Raven to use with this appender.

Method Detail

getLevel

protected static Event.Level getLevel(Level level)

Transforms a Level into an Event.Level.

Parameters:

level - original level as defined in JUL.

Returns:

log level used within raven.

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.

retrieveProperties

protected void retrieveProperties()

Retrieves the properties of the logger.

publish

public void publish(LogRecord record)

Specified by:

publish in class Handler

initRaven

protected void initRaven()

Initialises the Raven instance.

buildEvent

protected Event buildEvent(LogRecord record)

Builds an Event based on the log record.

Parameters:

record - Log generated.

Returns:

Event containing details provided by the logging system.

flush

public void flush()

Specified by:

flush in class Handler

close

public void close()
           throws SecurityException

Specified by:

close in class Handler

Throws:

SecurityException