📘

For general information about Rollbar's alerting features, check out the Notifications guide.

Setup

Configuration is per-project in Rollbar.

  1. In Rollbar, navigate to the project you want to integrate with Slack
  2. Click Settings → Notifications → Slack
  3. Click Connect with Slack
  4. Select the Slack team you want to integrate with and authorize the permission request.
  5. Select the channel or group you wish to receive messages for
  6. Click Enable Slack Integration
  7. Go to the slack channel and type @Rollbar, then press enter to invite the slack bot.

  1. Click Add to channel to confirm.

  1. You are now ready to configure Slack Notifications for one of your Rollbar Projects
  2. Select the Projects left hand menu
  3. Select the Rollbar Project that you want to configure Slack Notifications for
  4. Choose the Notifications sub-menu
  5. Choose Slack as the Notification Type and click the Configure button
  6. Add the Slack channel (that you added @Rollbar to) to the Channel or Group text box
  7. Send a test notification and click Save Settings.

  1. To add rules, choose from the templates dropdown, then Configure.

  1. Add the correct channel or group, then Create Rule.

  1. Go back to your project and trigger an error message.

Congrats! Slack is now integrated with Rollbar. Default rules will have been created for the various events that Rollbar notifies on. You can customize the rules by editing them, deleting them, or adding new ones.

Slack Actions

Slack notifications can include optional actions to allow you to

  • Assign to teammates
  • Resolve, mute, or reopen
  • Change level to critical,warning etc.

Actions can be enabled/disabled for all notifications within a project as well as individual notification rules.

📘

Reauthorization required

If you connected Slack to your Rollbar account prior to March 2019, you will need to reauthorize Rollbar's access to your Slack account to allow for new access scopes.

Slack OAuth migration

If you’re still using user tokens, please migrate to the bot.

  1. Click on Get Started to start the migration process.

  1. Click on Add to slack to add it to your workspace.

  1. Click Allow to continue.

  1. Complete Migration.

  1. Go to slack and invite the bot with @Rollbar to the channel, then follow the steps above in the Configuration per-project in Rollbar.

Tips & Tricks

  • You can configure what channel you send the notifications to on each individual rule.
  • You can customize the content of Slack messages by using notification variables.
  • In addition to notification variables, any data value sent in the JSON payload of an item or occurrence may be used as a variable, including custom data. Examples of usage are {{body.request.url}} and {{body.server.host}}. If your JSON payload includes the custom values { handler: { key: process-job, id:100 }} then you can use the variables {{body.handler.key}} and {{body.handler.id}} in your notifications. To view the full set of available values, look at the "Params" values of an occurrence in your project. All params besides the ones listed in the above notification variables must be prefaced with "body" and will be truncated to 100 characters.
  • You can mention specific Slack users in notification messages using the syntax <@username>.
  • To mention @here, or @everyone, use the syntax <!here>, or <!everyone>.
  • To mention a group use the syntax <!subteam^{your_slack_group_id}>.
  • To mention a channel use the syntax <#{your_slack_channel_id}>
  • To add a newline to the slack message, simply type it into the template, e.g.
[{{project_slug}}] - {{body.framework}} - {{level}} - {{trigger_description}}
{{title}}
{{link}}

If you would like to include the context value in a Slack notification, the example would look like this:

<{{link}}|#{{counter}} {{occurrence_title}} {{body.context}}>