Skip to content

amirmujkic/multi_bug

Repository files navigation

MultiBug

Error reporting via multiple platforms.

Build Status Release


Features

  • Easily switch error monitoring provider by changing config only
  • Supported adapters
  • Upcoming features
    • Aditional adapters for Sentry and Rollbar
    • Advanced configuration
    • Support for common advanced features

Getting started

To install, run:

gem install multi_bug

Add the following to your Gemfile:

gem "multi_bug", '~> 0.2.2'

After you've added the multi_bug gem, please install one of the gems for the monitoring platform you want to use. To accomplish that, you can use one of the following installation guides:

Usage

Reporting exceptions

After installing one of the supported gems, reporting of unhandled exceptions should happen automatically and be visible in their respective monitoring dashboard.

Reporting of handled exceptions can be done with:

begin
  raise 'Robots are taking over!'
rescue => exception
  MultiBug.notify(exception)
end

Custom payload

If you need to add custom payload to the error report you can do this by providing an options hash.

begin
  raise 'Robots are taking over!'
rescue => exception
  MultiBug.notify(exception, {
    foo: {
      bar: 'baz'
    }
  })
end

Changing the provider

Changing of the monitoring provider should be easily achieved just by installing/configuring the other gem.

Tests

To test, run:

bundle exec rspec

Versioning

Read Semantic Versioning for details. Briefly, it means:

  • Major (X.y.z) - Incremented for any backwards incompatible public API changes.
  • Minor (x.Y.z) - Incremented for new, backwards compatible, public API enhancements/fixes.
  • Patch (x.y.Z) - Incremented for small, backwards compatible, bug fixes.

Contributions

Read CONTRIBUTING for details.

License

Copyright 2018 . Read LICENSE for details.

History

Read CHANGES for details.