Alerts

Create custom Alerts to pair with Issues.

Sentry's Alerts help you take action on issues in your projects. When an issue changes state, is created, or passes a threshold, an alert is triggered to perform external actions like sending notifications, creating tickets, or calling webhooks and integrations. Choose to alert based on the conditions of specific Monitors, or all issues in a project.

  • Send a notification to your team's Slack channel when a new error occurs in an existing issue
  • Create a ticket in JIRA when an issue is created and a team member is assigned
  • Call a webhook or integration when an issue is created

To create an Alert, navigate to the Alerts page and click Create Alert.

The source of an Alert can come from either one or more projects, or one or more Monitors. Once you've selected your sources, you can set the environment(s) for the Alerts to run on. By default, Alerts will run on all environments.

A trigger is an action that must occur for the Alert to run. All trigger actions are issue state based. For example, you may want to send a notification to your team's Slack channel when an issue is created. You can select multiple triggers in a single Alert. They will run under an ANY condition, meaning that if any one of the triggers happen, the Alert will run.

Filters are conditions that must be met for the Alert to run. For example, you may want to create a ticket only for issues that are assigned to a specific team and at a certain severity. You can create multiple filters in a single Alert, and group them under either ANY or ALL conditions. For ANY conditions, if any one of the filters are true, the Alert will run. For ALL conditions, only if all of the filters are true, the Alert will run.

Actions are the events that will be executed when the Alert is run. You can send notifications on any channel you're integrated with, create tickets, for example, in JIRA, or call a webhook or integration. You can set multiple actions in a single Alert. Learn more about Sentry's integrations.

Note: Some Monitors can only alert on certain integrations. See Sentry's integrations for more information.

You can see a list of all your Alerts on the Alerts page. By default, Alerts are filtered down to your projects.

By clicking on an Alert, you can view the details, edit the Alert, or turn it on or off.

The details page will show a high level chart of how often the Alert has run, a list of the most recent runs, the configuration, and connected monitors.

Besides Alerts, Sentry sends you notifications about various things like issue state changes, release deploys, and quota usage. You can fine-tune these notifications, as well as your personal alert settings, in User Settings > Notifications. Learn more about notifications and adjusting their associated settings in the full documentation.

Was this helpful?
Help improve this content
Our documentation is open source and available on GitHub. Your contributions are welcome, whether fixing a typo (drat!) or suggesting an update ("yeah, this would be better").