Complete client setup

This guide describes how to complete the client setup after you've downloaded the application config file.

The instructions here are the same as you'll receive in StackHunter after download the above config file.

1. Add config file to classpath

After downloading stackhunter-client.properties, add it to your application's classpath. It must be in the root of your classpath and not in a package or folder.

  1. One option is to add it to your applications's WEB-INF/classes folder.
  2. Another option is to add it to your container's lib folder (for example ${catalina.base}/lib). However, this will be used when logging exceptions for all apps in this container.

(Note: there's no need to edit stackhunter-client.properties, it already contains the settings to allow your app to connect to the dashboard.)

2. Add servlet filter

Add the following servlet filter before other filters in your application's web.xml. If you're using an authentication filter like Spring Security, you may add the StackHunterServletFilter after it.

3. Add the client Jars

Remove any old StackHunter-*.jar files from your applications's WEB-INF/lib folder.

Copy the jars from client\*.jar to your applications's WEB-INF/lib folder
(you can exclude log4j-XXX.jar if you're app is using Logback/SL4J).

4. Add log4j config [OPTIONAL]
If you don't already have a log4j.properties file in your classpath, you may add client\log4j.properties to your server's classpath next to stackhunter-client.properties.
5. Test

Test by throwing (and not catching) an exception in your web app, then refresh the dashboard.

If you've setup email alerts, you should receive a new notification message shortly.

Next steps:

Contact Us

Other ways to reach us: eMAIL, Twitter