Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ref(alerts): Add docs for dynamic alerts #11158

Open
wants to merge 4 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions docs/organization/early-adopter-features/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -21,3 +21,4 @@ Limitations:
- [Span Summary](/product/performance/transaction-summary/#span-summary)
- [Investigation Mode](/product/performance/retention-priorities/#investigation-mode) for retention priorities in Tracing
- [Uptime Monitoring](/product/alerts/uptime-monitoring/)
- [Dynamic Alerts](/product/alerts/create-alerts/metric-alert-config/#dynamic-alerts)
4 changes: 4 additions & 0 deletions docs/product/alerts/alert-types.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,10 @@ The **Alert Details** page also includes a list of issues that triggered the ale

Metric alerts tell you when a [metric](/product/performance/metrics/) crosses a threshold set by you, like a spike in the number of errors in a project, or a change in a performance metric, such as [transaction duration](/product/performance/metrics/#latency), [Apdex](/product/performance/metrics/#apdex), [failure rate](/product/performance/metrics/#failure-rate), or [throughput](/product/performance/metrics/#throughput-total-tpm-tps).

<Note>
You can use [dynamic alerts](/product/alerts/create-alerts/metric-alert-config/#dynamic-alerts) to let Sentry define the threshold for you.
</Note>

ceorourke marked this conversation as resolved.
Show resolved Hide resolved
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 <PlatformLink to="/enriching-events/tags/">tags</PlatformLink>, which is particularly useful for aggregating across events that aren't grouped into single issues. Sentry allows a maximum of 1000 metric alerts for an organization.

<Note>
Expand Down
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
15 changes: 13 additions & 2 deletions docs/product/alerts/create-alerts/metric-alert-config.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -113,10 +113,11 @@ While Sentry won’t allow you to create new alerts with invalid or unavailable

## Thresholds

There are two threshold types:
There are three threshold types:

- **Static**: A fixed threshold, such as when there are 100 errors in a period of time.
ceorourke marked this conversation as resolved.
Show resolved Hide resolved
- **Percent change**: A dynamic threshold, such as when there are 10% more errors in a time period compared to a previous period. These are also referred to as [Change Alerts](#change-alerts-percent-change).
- **Percent change**: A percent based threshold, such as when there are 10% more errors in a time period compared to a previous period. These are also referred to as [Change Alerts](#change-alerts-percent-change).
ceorourke marked this conversation as resolved.
Show resolved Hide resolved
- **Dynamic**: A dynamic threshold set by Sentry that detects anomalies whenever values fall outside expected bounds.
ceorourke marked this conversation as resolved.
Show resolved Hide resolved

By default, metric alerts use a fixed threshold.

Expand All @@ -128,6 +129,16 @@ Change alerts, or alerts that use a percent change threshold, are useful when yo

![When the percent change option is selected.](./img/percent-change.png)

### Dynamic Alerts

<Include name="feature-available-for-user-group-early-adopter.mdx" />

Dynamic alerts can be used when you don't know what threshold to set, but you know you want to be alerted when something is far outside the bounds of normalcy. Sentry will look at the historical data for the given metric and determine if the current data is anomalous. You can select how responsive the alert will be, and whether you want to be alerted when the metric is above, below, or both above and below the expected bounds.
ceorourke marked this conversation as resolved.
Show resolved Hide resolved

Dynamic alerts do not use the Critical, Warning, and Resolved thresholds like other alert threshold types as you are not setting these yourself. When no more anomalies are detected, the alert will resolve.
ceorourke marked this conversation as resolved.
Show resolved Hide resolved

![When the dynamic threshold is selected.](./img/dynamic-threshold.png)

### Set Threshold to Trigger Alert

You can set the status of an alert rule when a threshold is met using the labels:
Expand Down
Loading