A Dart plugin for Rollbar.com

Import rollbar.dart.

import "package:rollbar/rollbar.dart" as rollbar;

Then wrap your main entrypoint into rollbar.install:

void main() {
  rollbar.install("your_access_token", () {
    var app = new App();
    app.run();
  });
}

That's it!

If you want, you can send any additional data to Rollbar, or overwrite the defaults the package sends. Just pass it as an additional argument to rollbar.install. E.g. you may want to pass the current user info:

var app;
rollbar.install("your_access_token", () {
  app = new App();
  app.run();
}, customPayload: () {
  return {"data": {"person": {"id": app.user.id, "email": app.user.email}}};
});

This will be merged into the default payload. You can send any additional data you want, just check the API docs to know your options (section "Data Format").

You also can provide your logger, then the plugin will write some debug info to it in 'finer' level

rollbar.install("your_access_token", () {
  var app = new App();
  app.run();
}, logger: Logger.root);

By default, source maps support is enabled, but you need to specify a version of uploaded source maps. You can do that this way:

var app;
rollbar.install("your_access_token", () {
  app = new App();
  app.run();
}, sourceMapsCodeVersion: () => app.version);

Or you can disable source maps at all:

var app;
rollbar.install("your_access_token", () {
  app = new App();
  app.run();
}, areSourceMapsEnabled: false);

You still have to upload source maps by yourself when you deploy your app, with the same version as you specified in sourceMapsCodeVersion. Check source maps docs for more information.

If you want to execute some custom code when exception happens you can pass a function to onError argument:

rollbar.install("your_access_token", () {
  var app = new App();
  app.run();
}, onError: (error, StackTrace stackTrace) {
  // do something with error and/or stackTrace
});