Notifications

Learn about the types of notifications that Sentry sends you, and how to manage them.

Sentry sends you notifications regarding workflow activities, release deploys, and quota usage, as well as weekly reports. These notifications let you know about:

  • Workflow: Activity involving user actions and state changes on issues. This includes activities such as issue resolution, assignment, comments, and regressions.
  • Deploy: When a release you have commits on is deployed.
  • Spend: When you're getting close to spending your reserved volume, your quotas are depleted, and/or your pay-as-you-go budget is being put to use.
  • Weekly Reports: A summary of your organization's Sentry activity.

You can manage these notifications in User Settings > Notifications.

Sentry sends workflow notifications to let you know about issue state changes. Workflow relates to actions that help you manage your issues, such as changing an issue’s state or commenting on it. By default, Sentry sends these notifications by email to members who are subscribed to the issue (see below for how subscription is determined). Workflow notifications are sent for:

  • Issue Resolved: When a new issue is spotted in your code, it's in the Unresolved state. The issue state changes to Resolved when a project team member resolves it, either by manually changing its state in sentry.io) or by submitting a fix, or because of the project’s auto-resolve feature (if configured).
  • Regressions: A regression happens when the state of an issue changes from Resolved back to Unresolved. An email is sent to all project team members.
  • Comments: When a team member adds a new comment in the “Activity” tab of the detail page for the issue.
  • Assignment: When an issue is assigned or unassigned.
  • User Feedback: When an issue has new user feedback.
  • Event Processing Problems: When there's a problem with processing error events you've sent to Sentry.

You receive workflow notifications when you subscribe to an issue in one of the following ways by:

  • You or your team being assigned to the issue
  • Clicking the bell icon to subscribe to an issue
  • Commenting on an issue
  • Bookmarking an issue
  • Resolving, unresolving, or archiving an issue
  • Resolving an unassigned issue with the "Claim Unassigned Issues I've Resolved" option turned on

You or your team will become participants once you're subscribed to an issue. Participants can be viewed from the right hand sidebar at the bottom of the issue details page. Note that participant notifications may have some overlap with alerts that are configured on a per-project basis.

You'll be unsubscribed from an issue if you:

  • Are unassigned from the issue
  • Delete the only comment you left on an issue
  • Remove a bookmark from an issue

Sentry sends deploy notifications to users who have committed to the release that was deployed. Learn more in the deploy documentation.

An example of an email describing deployed features

By default, Sentry sends spend notifications to all owners and billing members of an organization when:

  • 80% of the organization's reserved volume (such as errors, spans, and/or attachments) has been depleted.
  • The entire reserved volume and any pay-as-you-go budget for a category (such as errors, spans, and/or attachments) has been depleted.
  • 80% of the organization's pay-as-you-go budget has been used.

Learn more in the Pricing & Billing docs.

Billing or owner members can set up their notification thresholds by going to: Settings > Subscriptions > Notifications.

Notifications tab of Subscription settings page

From here, you can customize the notification thresholds for your organization for when you're close to reaching one or both of the below:

  • Subscription Consumption: Set the percentage of the quota usage threshold(s) that will trigger a notification.

  • Pay-as-you-go Consumption: Set the percentage of the Pay-as-you-go usage threshold(s) that will trigger a notification.

Owner and billing members of an organization can also customize how they personally receive spend notifications. This can be done from the user's notification settings page:

  1. Go to the Notifications page (in your User Settings).
  2. Scroll to the Spend row and click on the cog wheel.
  3. From the Spend Notifications page, you'll be able to select the types of notifications you get as well as how you'd like to get them (via Slack, email, and so on).

Sentry sends weekly reports every Saturday, by email. Reports contain a summary of your organization's Sentry activity over the last week.

Weekly Report email sample.

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").