io.sentry.jul

Class SentryHandler

java.lang.Object

java.util.logging.Handler

io.sentry.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 boolean	printfStyle If true, String.format() is used to render parameterized log messages instead of MessageFormat.format(); Defaults to false.
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.

Method Summary

Methods

Modifier and Type	Method and Description
void	close()
protected EventBuilder	createEventBuilder(LogRecord record) Builds an EventBuilder based on the log record.
void	flush()
protected String	formatMessage(String message, Object[] parameters) Returns formatted Event message when provided the message template and parameters.
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.
void	publish(LogRecord record)
protected void	retrieveProperties() Retrieves the properties of the logger.
void	setPrintfStyle(boolean printfStyle)

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

printfStyle

protected boolean printfStyle

If true, String.format() is used to render parameterized log messages instead of MessageFormat.format(); Defaults to false.

Constructor Detail

SentryHandler

public SentryHandler()

Creates an instance of SentryHandler.

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 sentry.

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

createEventBuilder

protected EventBuilder createEventBuilder(LogRecord record)

Builds an EventBuilder based on the log record.

Parameters:

record - Log generated.

Returns:

EventBuilder containing details provided by the logging system.

formatMessage

protected String formatMessage(String message,
                   Object[] parameters)

Returns formatted Event message when provided the message template and parameters.

Parameters:

message - Message template body.

parameters - Array of parameters for the message.

Returns:

Formatted message.

flush

public void flush()

Specified by:

flush in class Handler

close

public void close()
           throws SecurityException

Specified by:

close in class Handler

Throws:

SecurityException

setPrintfStyle

public void setPrintfStyle(boolean printfStyle)