net.gini.dropwizard.gelf.logging

Class UncaughtExceptionHandlers

java.lang.Object

net.gini.dropwizard.gelf.logging.UncaughtExceptionHandlers

public final class UncaughtExceptionHandlers
extends Object

Simple factory for a Thread.UncaughtExceptionHandler which logs the last uncaught exception with a SLF4J Logger on ERROR level.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UncaughtExceptionHandlers.LoggingSystemExitBuilder

Method Summary

Modifier and Type	Method and Description
static UncaughtExceptionHandlers.LoggingSystemExitBuilder	loggingSystemExitBuilder(String facility, String host) Returns a builder for an exception handler that bootstraps a GELF log appender, logs the uncaught exception and then exits the system.
static Thread.UncaughtExceptionHandler	systemExit() Returns an exception handler that logs the uncaught exception to System.err and then exits the system.

Methods inherited from class java.lang.Object

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

Method Detail

loggingSystemExitBuilder

public static UncaughtExceptionHandlers.LoggingSystemExitBuilder loggingSystemExitBuilder(String facility,
                                                                                          String host)

Returns a builder for an exception handler that bootstraps a GELF log appender, logs the uncaught exception and then exits the system. This is particularly useful for the main thread, which may start up other, non-daemon threads, but fail to fully initialize the application successfully.
Example usage:

public static void main(String[] args) {
   Thread.currentThread().setUncaughtExceptionHandler(
       UncaughtExceptionHandlers.loggingSystemExitBuilder("some-service", "log.example.com").build());
   ...
 

Parameters:

facility - The facility to use in the GELF messages

host - The host of the Graylog server

Returns:

builder object for building the exception handler

systemExit

public static Thread.UncaughtExceptionHandler systemExit()

Returns an exception handler that logs the uncaught exception to System.err and then exits the system. This is particularly useful for the main thread, which may start up other, non-daemon threads, but fail to fully initialize the application successfully.
Example usage:

public static void main(String[] args) {
   Thread.currentThread().setUncaughtExceptionHandler(
       UncaughtExceptionHandlers.systemExit());
   ...
 

Returns:

exception handler