. Ultimately the windows and burn rates are what drives alerting, but the SLO duration is still required so that error budget consumption can be calculated. Additionally, we can use the SLO duration to show SLO adherence over the trailing window if we like.

| Field | Type | Description | |---|---|---| | slo_duration | [google.protobuf.Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration "google.protobuf.Duration") | Currently only supports 7 days and 30 days. | | slo_target | double | A percentage expressed as a number between 0 and 1. E.g., 0.99 for 99% or 0.95 for 95%. | | limit_strategy | [bitdrift.public.unary.charts.v1.LimitStrategy](bitdrift_public_unary_charts_v1_LimitStrategy.md "bitdrift.public.unary.charts.v1.LimitStrategy") | Optional limit strategy to use for this alert. If this is omitted, a default value of limiting by a top k of 5 entries is used. Ultimately this will allow alerting on specific dimensions for a group by aggregate ID if desired. | | window_and_burn_rates | array of [bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate](#bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate "bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate")
between 1 and 10 items | The list of window and burn rates to use for the SLO alert. Each WindowAndBurnRate defines a short and long window, as well as a burn rate. The alert will trigger if any of the WindowAndBurnRates breach the SLO target based on the burn rate. |

Example

```json { "limit_strategy": { "exclusions": { "dimension_identifiers": [ { "id": "time_series_id_opaque_example", "labels": [ { "name": "name", "value": "value" } ] } ], "return_other": false }, "sort_order": "MAX", "top_k_limit": { "top_k": 5 } }, "slo_duration": "3600s", "slo_target": 0.99, "window_and_burn_rates": [ { "burn_rate": 14.0, "long_window": "3600s", "notifications": { "custom_notification_text": "@incident-commander Review the current burn rate.", "notifications": [ { "min_time_between_notifications": "3600s", "notification_config": { "disabled": false, "notification_group": { "name": "engineering-oncall" } } } ] }, "short_window": "3600s" } ] } ``` # SloAlertConfig.WindowAndBurnRate **Source definition:** [`src/bitdrift/public/unary/alerts/v1/alerts.proto#L69-L92`]() SLO alerts use MWMBR (Multi-Window/Multi-Burn Rate). Each alert evaluation looks at every WindowAndBurnRate and alerts if any of them alert. For an individual WindowAndBurnRate to alert both the short window AND long window must breach based on the SLO target and burn rate.

| Field | Type | Description | |---|---|---| | short_window | [google.protobuf.Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration "google.protobuf.Duration") | Short evaluation window for this burn-rate policy. | | long_window | [google.protobuf.Duration](https://protobuf.dev/reference/protobuf/google.protobuf/#duration "google.protobuf.Duration") | Long evaluation window for this burn-rate policy. | | burn_rate | double | Burn rate threshold that causes this policy to trigger. | | notifications | [bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate.OverrideNotifications](#bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate.OverrideNotifications "bitdrift.public.unary.alerts.v1.SloAlertConfig.WindowAndBurnRate.OverrideNotifications") | Notification targets for the alert when this WindowAndBurnRate triggers. If unset, the CommonAlertConfig.notifications will be used. |

Example

```json { "burn_rate": 14.0, "long_window": "3600s", "notifications": { "custom_notification_text": "@incident-commander Review the current burn rate.", "notifications": [ { "min_time_between_notifications": "3600s", "notification_config": { "disabled": false, "notification_group": { "name": "engineering-oncall" } } } ] }, "short_window": "3600s" } ``` # SloAlertConfig.WindowAndBurnRate.OverrideNotifications **Source definition:** [`src/bitdrift/public/unary/alerts/v1/alerts.proto#L71-L78`]() Overrides the default notification settings for this burn-rate window.

| Field | Type | Description | |---|---|---| | notifications | array of [bitdrift.public.unary.alerts.v1.RateLimitedNotificationConfig](bitdrift_public_unary_alerts_v1_RateLimitedNotificationConfig.md "bitdrift.public.unary.alerts.v1.RateLimitedNotificationConfig")
up to 100 items | Notification targets for the alert when this OverrideNotifications is used. | | custom_notification_text | optional string
up to 2048 chars | Custom notification text to use when this OverrideNotifications is used. If not set, the CommonAlertConfig.custom_notification_text will be used. |

Example

```json { "custom_notification_text": "@incident-commander Review the current burn rate.", "notifications": [ { "min_time_between_notifications": "3600s", "notification_config": { "disabled": false, "notification_group": { "name": "engineering-oncall" } } } ] } ```