Alert Types

You can create two types of alerts:

  1. Issue alerts: Trigger when an issue (a grouped set of error events) matches a specific criteria.
  2. Metric alerts: Trigger when macro-level metrics for error or transaction events cross specific thresholds.

Issue Alerts

Issue alerts trigger whenever any issue in a project matches the specified criteria. These criteria might be, for example, a resolved issue re-appearing or an issue affecting many users.

In the “Alert Rules” tab, these alerts are identified by the issues icon, and by default, they are displayed at the bottom of your list of alerts. (If you have several metric alerts, this may push your issue alerts off the first page of the list.)

Issue alert rules at the bottom of the list of alerts.

In issue alerts, Sentry evaluates the configured alert conditions each time it receives a new event. Alert conditions have three parts:

  1. Triggers specify what type of activity you'd like monitored, or When an alert should be triggered.
  2. Filters help control noise by triggering an alert only If the issue matches the specified criteria.
  3. Then, Actions specify what should happen when the trigger conditions are met and the filters match.

Metric Alerts

Metric alerts tell you when a metric crosses a threshold, such as a spike in the number of errors in a project, or a change in a performance metric, like latency, Apdex, failure rate, or throughput.

Metric alerts monitor macro-level metrics for both error and transaction events. A metric takes a set of events and computes an aggregate value using a function, such as count() or avg(), applied to the event properties over a period of time. When you create a metric alert, you can filter events by attributes and tags, which is particularly useful for aggregating across events that aren't grouped into single issues.

These alerts use Critical and Warning triggers to measure severity. An alert’s current status is the highest severity trigger that is active, which can be one of three values: Warning, Critical, or Resolved. Sentry notifies you whenever an alert's status changes.

When you create an alert, all the displayed alert types (except “Issues”) may be used to create a metric alert:

  • Number of Errors
  • Users Experiencing Errors
  • Throughput
  • Transaction Duration
  • Apdex
  • Failure Rate
  • Largest Contentful Display
  • First Input Delay
  • Cumulative Layout Shift
  • Custom Metric

Alert Details

The Alert Details page shows you the history of a metric alert rule for the last 24 hours by default, though can modify the time period using the "Display" dropdown. When an alert is triggered, clicking the notification you receive takes you to this page, which displays the period when the alert was active. The page also includes details such as the alert rule conditions, the current status of the alert, and a summary of how much time the alert spent in each state (Critical, Warning, or Resolved).

Alert details illustrates a graph showing the performance of a transaction over time.

The Alert Details page also includes a list of suspect issues or transactions related to the metric, to help pinpoint the root problem more quickly. You can see what might have caused the alert to be triggered, and then open the metric in Discover to find more information. 

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