Using honebadger log4j appender

In order to use the honeybadger-log4j-appender in a maven project add the library as dependency:

<dependency>
  <groupId>com.workable.honeybadger</groupId>
  <artifactId>honeybadger-log4j-appender</artifactId>
  <version>0.1-SNAPSHOT</version>
</dependency>

Configure aHoneybadgerAppender in log4 configuration. The apiKey property can be retrieved from the API Keys page that resides in Settings tab of the honeybadger web interface.

log4j.properties sample

log4j.rootLogger=ALL, HoneybadgerAppender

# mandatory settings
log4j.appender.HoneybadgerAppender=com.workable.honeybadger.log4j.HoneybadgerAppender
log4j.appender.HoneybadgerAppender.layout=org.apache.log4j.EnhancedPatternLayout
log4j.appender.HoneybadgerAppender.layout.ConversionPattern=[%-5p] %c - %m%n%throwable{none}
log4j.appender.HoneybadgerAppender.threshold=ERROR
log4j.appender.HoneybadgerAppender.apiKey=#API_KEY#

#optional settings
log4j.appender.HoneybadgerAppender.async=true
log4j.appender.HoneybadgerAppender.maxThreads=1
log4j.appender.HoneybadgerAppender.queueSize=50000
log4j.appender.HoneybadgerAppender.priority=1

log4j xml sample

<appender name="honeybadger" class="com.workable.honeybadger.log4j.HoneybadgerAppender">
		<param name="Threshold" value="ERROR" />
		<layout class="org.apache.log4j.PatternLayout">
			<param name="ConversionPattern" value="[%-5p] %c - %m%n%throwable{none}" />
		</layout>
		<param name="apiKey" value="${honeybadger.apiKey}" />
</appender>

Any log4j event that carries a java.lang.Throwable will be dispatched to honeybadger via the available Collector API