diff --git a/docs/organization/early-adopter-features/index.mdx b/docs/organization/early-adopter-features/index.mdx index eabbe97b64cac..bd650daad1637 100644 --- a/docs/organization/early-adopter-features/index.mdx +++ b/docs/organization/early-adopter-features/index.mdx @@ -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) diff --git a/docs/product/alerts/alert-types.mdx b/docs/product/alerts/alert-types.mdx index 3b38b12b2c80e..e69142ba4fba9 100644 --- a/docs/product/alerts/alert-types.mdx +++ b/docs/product/alerts/alert-types.mdx @@ -37,6 +37,8 @@ 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). +You can use [dynamic alerts](/product/alerts/create-alerts/metric-alert-config/#dynamic-alerts) to let Sentry define the threshold for you. + 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. Sentry allows a maximum of 1000 metric alerts for an organization. diff --git a/docs/product/alerts/create-alerts/img/dynamic-threshold.png b/docs/product/alerts/create-alerts/img/dynamic-threshold.png new file mode 100644 index 0000000000000..2c72dc7bd4985 Binary files /dev/null and b/docs/product/alerts/create-alerts/img/dynamic-threshold.png differ diff --git a/docs/product/alerts/create-alerts/metric-alert-config.mdx b/docs/product/alerts/create-alerts/metric-alert-config.mdx index 1dc427b3b2f58..dd13cc6a57eed 100644 --- a/docs/product/alerts/create-alerts/metric-alert-config.mdx +++ b/docs/product/alerts/create-alerts/metric-alert-config.mdx @@ -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. -- **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). +- **Static**: A fixed numerical threshold set by you. (For example, if there are 100 errors in a set period of time.) +- **Percent change**: A percent-based threshold set by you. (For example, if 10% more errors are detected in a time period compared to a previous period.) These are also referred to as [Change Alerts](#change-alerts-percent-change). +- **Dynamic**: A dynamic threshold set by Sentry that detects anomalies whenever values fall outside of expected bounds. By default, metric alerts use a fixed threshold. @@ -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 + + + +Dynamic alerts can be used when you're not sure about what threshold to set, but want to be alerted when something is far outside the bounds of normalcy. To determine what is and isn't normal, Sentry will look at the historical data for the given metric and compare it to the current data to see if it's anomalous. You can select how responsive the alert will be, and whether you want to be alerted when the metric is above and/or below the expected bounds. + +Dynamic alerts don't use the Critical, Warning, and Resolved thresholds. When no more anomalies are detected, the alert will resolve on its own. + +![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: