The Bugsnag Notifier for Java gives you instant notification of exceptions
thrown from your Java applications.
The notifier hooks into Thread.UncaughtExceptionHandler
, so any
uncaught exceptions in your app will be sent to your Bugsnag dashboard.
Bugsnag captures errors in real-time from your websites and mobile applications, helping you to understand and resolve them as fast as possible. Create a free account to start capturing errors from your applications.
-
Download the latest bugsnag.jar and place it in your app's classpath.
Bugsnag for Java depends only on the
org.json
library, download the jar here.Note: if your project uses Maven you can instead add bugsnag as a dependency in your
pom.xml
. -
Import the Bugsnag
Client
class in your code and create an instance to begin capturing exceptions:import com.bugsnag.Client; Client bugsnag = new Client("your-api-key-goes-here");
It is often useful to send additional meta-data about your app, such as
information about the currently logged in user, along with any exceptions,
to help debug problems. To add custom data to every exception you can
use addToTab
:
bugsnag.addToTab("User", "Name", "Bob Hoskins");
bugsnag.addToTab("User", "Paying Customer?", true);
If you would like to send non-fatal exceptions to Bugsnag, you can pass any
Throwable
object to the notify
method:
bugsnag.notify(new RuntimeException("Non-fatal"));
You can also send additional meta-data with your exception:
import com.bugsnag.MetaData;
MetaData metaData = new MetaData();
metaData.addToTab("User", "username", "bob-hoskins");
metaData.addToTab("User", "email", "bob@example.com");
bugsnag.notify(new RuntimeException("Non-fatal"), metaData);
###setContext
Bugsnag uses the concept of "contexts" to help display and group your errors. Contexts represent what was happening in your application at the time an error occurs.
bugsnag.setContext("MyActivity");
###setUserId
Bugsnag helps you understand how many of your users are affected by each error. In order to do this, we need to send along a userId with every exception.
If you would like to enable this, set the userId
, for example to set it to
be a username of your currently logged in user, you can call setUserId
:
bugsnag.setUserId("leeroy-jenkins");
###setReleaseStage
If you would like to distinguish between errors that happen in different
stages of the application release process (development, production, etc)
you can set the releaseStage
that is reported to Bugsnag.
bugsnag.setReleaseStage("development");
By default this is set to be "production".
###setNotifyReleaseStages
By default, we will notify Bugsnag of exceptions that happen in any
releaseStage
. If you would like to change which release stages notify
Bugsnag of exceptions you can call setNotifyReleaseStages
:
bugsnag.setNotifyReleaseStages(new String[]{"production", "development"});
###setAutoNotify
By default, we will automatically notify Bugsnag of any fatal exceptions
in your application. If you want to stop this from happening, you can call
setAutoNotify
:
bugsnag.setAutoNotify(false);
###setFilters
Sets the strings to filter out from the extraData
maps before sending
them to Bugsnag. Use this if you want to ensure you don't send
sensitive data such as passwords, and credit card numbers to our
servers. Any keys which contain these strings will be filtered.
bugsnag.setFilters(new String[]{"password", "credit_card_number"});
By default, filters
is set to new String[] {"password"};
###setProjectPackages
Sets which package names Bugsnag should consider as "inProject". We mark stacktrace lines as in-project if they originate from any of these packages.
bugsnag.setProjectPackages("com.company.package1", "com.company.package2");
###setIgnoreClasses
Sets for which exception classes we should not send exceptions to Bugsnag.
bugsnag.setIgnoreClasses("java.io.IOException", "com.example.Custom");
Please report any bugs or feature requests on the github issues page for this project here:
https://github.com/bugsnag/bugsnag-java/issues
- Fork the notifier on github
- Commit and push until you are happy with your contribution
- Make a pull request
- Thanks!
The Bugsnag Java notifier is free software released under the MIT License. See LICENSE.txt for details.