Slack Integration

Based off of this post

Create a Slack App

To use Sentry’s new Slack integration you’ll need to create an app in Slack bot app. Navigate to Your Apps and click Create new App.

Create

After naming your app and connecting your workspace, navigate to Basic Information. Here you’ll find your Client ID, Client Secret, and Verification token that lets your app access the Slack API.

Here’s where you’ll connect your self-hosted Sentry instance to your newly created Slack app.

system.admin-email
Declared in config.yml.
Copy your Client ID, Client Secret, and Verification Token.

Set slack.legacy-app to False if you made your bot Post June 2020, due to slack api changes

If slack.legacy-app is True please use slack.verification-token instead of slack.signing-secret

Copied
slack.client-id: <'client id'>
slack.client-secret: <client secret>
slack.signing-secret: <signing secret>
slack.legacy-app: <boolean>
After you update the config.yml you need to restart your Sentry server to continue configuring the Slack app.

Now that you’ve created your app and updated your Sentry config, you can navigate to Interactive Components under Features.

Click Enable Interactive Components and you’ll be able to enter your Request URL (this is the location of your self-hosted Sentry) and Options Load URL:

Copied
Request URL: https://your-sentry-server.com/extensions/slack/action/
Options Load URL: https://your-sentry-server.com/extensions/slack/options-load/

Click Enable Interactive Components and Slack will confirm if the HTTP request to the URL you entered succeeds or fails.

Navigate to OAuth & Permissions to configure the Redirect URLs.

OAuth

Click Add a new Redirect URL, enter the URL, and click Add. The URL will look like:

Copied
https://your-sentry-server.com/extensions/slack/setup/

Click Save URLs.

On the same page under Scopes in the Select Permission Scopes dropdown menu, add:

  • links:read

Click Save Changes.

Note: You have the option to set Restrict API Token Usage on this page if you want to ensure your Slack is the only one talking to your Sentry instance.

Navigate to Event Subscription and toggle “On”. Here you will enter another Request URL in the following format: https://your-sentry-server.com/extensions/slack/event/

You’ll see “Verified” when you’ve entered the correct URL.

Events

Note: When you enter the Request URL, Slack tries to verify it. The request will fail if you didn’t configure the client keys/secret and restarted Sentry to ensure those config changes were picked up. If it fails to validate, first make sure your Sentry instance is running and Slack can talk to it (Slack doesn’t have an ip range)

On the same page under Selected Events, click Add Workspace Event and search for link_shared:

On the same page under App Unfurl Domains, click Add Domain to enter your domain and click Done.

At the bottom of the page, click Save Changes.

Navigate to Bot Users

Click Add a Bot User and give your sentry app bot a name (this is the name that will be displayed when alerts are triggered)

Bot

Now you can use Slack with Sentry! See our documentation on configuring the Slack integration for your projects to take advantage of multi-channel Alert routing with the new integration.

You can edit this page on GitHub.