public class DeathRattleExceptionHandler extends Object implements Thread.UncaughtExceptionHandler
When a thread throws an Exception that was not caught, a DeathRattleExceptionHandler will increment a counter signalling a thread has died and print out the name and stack trace of the thread. This makes it easy to build alerts on unexpected Thread deaths and fine grained used quickens debugging in production.
You can also set a DeathRattleExceptionHandler as the default exception handler on all threads, allowing you to get information on Threads you do not have direct control over.
Usage is straightforward:
final Counter c = Metrics.newCounter(MyRunnable.class, "thread-deaths");
Thread.UncaughtExceptionHandler exHandler = new DeathRattleExceptionHandler(c);
final Thread myThread = new Thread(myRunnable, "MyRunnable");
myThread.setUncaughtExceptionHandler(exHandler);
Setting the global default exception handler should be done first, like so:
final Counter c = Metrics.newCounter(MyMainClass.class, "unhandled-thread-deaths");
Thread.UncaughtExceptionHandler ohNoIDidntKnowAboutThis = new DeathRattleExceptionHandler(c);
Thread.setDefaultUncaughtExceptionHandler(ohNoIDidntKnowAboutThis);
| Constructor and Description |
|---|
DeathRattleExceptionHandler(Counter counter)
Creates a new
DeathRattleExceptionHandler with the given Counter. |
public DeathRattleExceptionHandler(Counter counter)
DeathRattleExceptionHandler with the given Counter.counter - the Counter which will be used to record the number of uncaught
exceptionspublic void uncaughtException(Thread t, Throwable e)
uncaughtException in interface Thread.UncaughtExceptionHandlerCopyright © 2005–2018. All rights reserved.