Skip to content

Commit cf2623e

Browse files
committed
feat(alerts): Add anomaly detection docs
1 parent 5e56c31 commit cf2623e

File tree

3 files changed

+20
-2
lines changed

3 files changed

+20
-2
lines changed

docs/organization/early-adopter-features/index.mdx

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,3 +21,4 @@ Limitations:
2121
- [Span Summary](/product/performance/transaction-summary/#span-summary)
2222
- [Investigation Mode](/product/performance/retention-priorities/#investigation-mode) for retention priorities in Tracing
2323
- [Uptime Monitoring](/product/alerts/uptime-monitoring/)
24+
- [Dynamic Alerts](/product/alerts/create-alerts/metric-alert-config/#dynamic-alerts)

docs/product/alerts/alert-types.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,10 @@ The **Alert Details** page also includes a list of issues that triggered the ale
3737

3838
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).
3939

40+
<Note>
41+
You can use [dynamic alerts](/product/alerts/create-alerts/metric-alert-config/#dynamic-alerts) to let Sentry define the threshold for you.
42+
</Note>
43+
4044
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.
4145

4246
<Note>

docs/product/alerts/create-alerts/metric-alert-config.mdx

Lines changed: 15 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -113,10 +113,11 @@ While Sentry won’t allow you to create new alerts with invalid or unavailable
113113

114114
## Thresholds
115115

116-
There are two threshold types:
116+
There are three threshold types:
117117

118118
- **Static**: A fixed threshold, such as when there are 100 errors in a period of time.
119-
- **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).
119+
- **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).
120+
- **Dynamic**: A dynamic threshold set by Sentry that detects anomalies whenever values fall outside expected bounds.
120121

121122
By default, metric alerts use a fixed threshold.
122123

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

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

132+
### Dynamic Alerts
133+
134+
<Include name="feature-available-for-user-group-early-adopter.mdx" />
135+
136+
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.
137+
138+
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.
139+
140+
TODO update this image when deploy is finished
141+
142+
![When the percent change option is selected.](./img/percent-change.png)
143+
131144
### Set Threshold to Trigger Alert
132145

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

0 commit comments

Comments
 (0)