SLO error budget monitors are threshold based and notify you when a certain percentage of your SLO’s error budget has been consumed. For example, alert me if 75% of the error budget for my 7-day target is consumed. Warn me if 50% is consumed (optional).
Note: Error budget monitors are only available for metric-based SLOs.
threshold
over the past target
number of days.Note: Clicking the New Condition
button adds an optional warning condition. The warning threshold must be less than the alert threshold.
You can create SLO error budget monitors using the create-monitor API endpoint. Below is an example query for an SLO monitor, which alerts when more than 75% of the error budget of an SLO is consumed:
error_budget("slo_id").over("time_window") > 75
In addition, SLO error budget monitors can also be created using the datadog_monitor resource in Terraform. Below is an example .tf
for configuring an error budget monitor for a metric-based SLO using the same example query as above.
Note: SLO error budget monitors are only supported in Terraform provider v2.7.0 or earlier and in provider v2.13.0 or later. Versions between v2.7.0 and v2.13.0 are not supported.
resource "datadog_monitor" "metric-based-slo" {
name = "SLO Error Budget Alert Example"
type = "slo alert"
query = <<EOT
error_budget("slo_id").over("time_window") > 75
EOT
message = "Example monitor message"
thresholds = {
critical = 75
}
tags = ["foo:bar", "baz"]
}
Replace slo_id
with the alphanumeric ID of the metric-based SLO you wish to configure an error budget monitor on and replace time_window
with one of 7d
, 30d
or 90d
- depending on which target is used to configure your metric-based SLO.