Rollbar Java SDK

Proactively discover, predict, and resolve errors in real-time with Rollbar’s error monitoring platform. Start tracking errors today!

The current library has undergone a major overhaul between versions 0.5.4 and 1.0.0. We recommend upgrading from prior versions of rollbar-java, but that process may require some work on your end for the more complex use cases of the old library.

The code is documented with javadoc and therefore should be usable from viewing the documentation in the source. There are examples in the examples directory showing different use cases for consuming these libraries.

Key benefits of using Rollbar Java SDK are:

• Cross platform: Rollbar Java SDK supports both server-side and mobile Java applications, including plaforms such as Android, Scala, Spring, Web and more!
• Automatic error grouping: Rollbar aggregates Occurrences caused by the same error into Items that represent application issues. Learn more about reducing log noise.
• Advanced search: Filter items by many different properties. Learn more about search.
• Customizable notifications: Rollbar supports several messaging and incident management tools where your team can get notified about errors and important events by real-time alerts. Learn more about Rollbar notifications.

Setup Instructions

1. Sign up for a Rollbar account
2. Follow the Installation instructions in our Java SDK docs to install rollbar-java and configure it for your platform.

Usage

For actual usage, the easiest way to get started is by looking at the examples:

• rollbar-java
• rollbar-web
• rollbar-android
• rollbar-scala
• rollbar-log4j2
• rollbar-logback
• rollbar-spring-webmvc
• rollbar-spring-boot-webmvc
• rollbar-reactive-streams-reactor

Data scrubbing

Payloads are scrubbed before they are sent, with no configuration required: fields named after secrets (password, secret, token, authorization, api_key, …) and a deny-list of authentication headers are redacted, and URLs have their userinfo, query string and fragment stripped. You can add your own keys with redactedKeys, turn the built-in key list off with useDefaultRedactedKeys(false), and change the URL handling with urlSanitizer.

See SCRUBBING.md for what is redacted by default, how to configure it, and the migration impact if you are upgrading from a version minor or equal than 2.3.1.

Release History & Changelog

See our Releases page for a list of all releases, including changes.

Help / Support

If you run into any issues, please email us at [email protected]

For bug reports, please open an issue on GitHub.

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature).
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

License

Rollbar-java is free software released under the MIT License. See LICENSE.txt for details.