Skip to content

Commit d34ca92

Browse files
estherk15Rifa-Tamannaacswatt
authored
SLO burn rate indicator (#32688)
* Update _index.md with burn rate indicator information Also updated SLO status pge to say SLO manage page instead * Add SLO burn rate indicator * Apply suggestions from code review Co-authored-by: cecilia saixue wat-kim <cecilia.watt@datadoghq.com> --------- Co-authored-by: Rifa-Tamannaa <rifa.tamanna@datadoghq.com> Co-authored-by: cecilia saixue wat-kim <cecilia.watt@datadoghq.com>
1 parent fca36bb commit d34ca92

File tree

2 files changed

+30
-16
lines changed

2 files changed

+30
-16
lines changed

content/en/service_management/service_level_objectives/_index.md

Lines changed: 30 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ further_reading:
3030
text: "Create and manage SLOs with Terraform"
3131
- link: "https://www.datadoghq.com/blog/burn-rate-is-better-error-rate/"
3232
tag: "Blog"
33-
text: "Burn Rate is a Better Error Rate"
33+
text: "Burn Rate is a Better Error Rate"
3434
---
3535

3636
{{< jqmath-vanilla >}}
@@ -72,13 +72,13 @@ For a full comparison, see the [SLO Type Comparison][1] chart.
7272

7373
## Setup
7474

75-
Use Datadog's [Service Level Objectives status page][2] to create new SLOs or to view and manage all your existing SLOs.
75+
Use Datadog's [Service Level Objectives manage page][2] to create new SLOs or to view and manage all your existing SLOs.
7676

7777
### Configuration
7878

79-
1. On the [SLO status page][2], select **New SLO +**.
79+
1. On the [SLO manage page][2], select **New SLO +**.
8080
2. Select the SLO type. You can create an SLO with any of the following types: [Metric-based][3], [Monitor-based][4], or [Time Slices][5].
81-
3. Set a target and a rolling time window (past 7, 30, or 90 days) for the SLO. Datadog recommends you make the target stricter than your stipulated SLAs. If you configure more than one time window, select one to be the primary time window. This time window is displayed on SLO lists. By default, the shortest time window is selected.
81+
3. Set a target and a rolling time window (past 7, 30, or 90 days) for the SLO. Datadog recommends you make the target stricter than your stipulated SLAs. If you configure more than one time window, select one to be the primary time window. This time window is displayed on SLO lists. By default, the shortest time window is selected.
8282
4. Finally, give the SLO a title, describe it in more detail or add links in the description, add tags, and save it.
8383

8484
After you set up the SLO, select it from the [Service Level Objectives list view][2] to open the details side panel. The side panel displays the overall status percentage and remaining error budget for each of the SLO's targets, as well as status bars (monitor-based SLOs) or bar graphs (metric-based SLOs) of the SLI's history. If you created a grouped monitor-based SLO using one [multi alert monitor][6] or a grouped metric-based SLO using the [`sum by` clause][7], the status percentage and remaining error budget for each individual group is displayed in addition to the overall status percentage and remaining error budget.
@@ -115,12 +115,12 @@ To create, edit, and delete status corrections, users require the `slos_correcti
115115

116116
### Granular access controls
117117

118-
Restrict access to individual SLOs by specifying a list of [roles][10] that are allowed to edit it.
118+
Restrict access to individual SLOs by specifying a list of [roles][10] that are allowed to edit it.
119119

120120
{{< img src="service_management/service_level_objectives/slo_set_permissions.png" style="width:100%; background:none; border:none; box-shadow:none;" alt="SLO permissions option in the cog menu">}}
121121

122-
1. Click on the SLO to open the details side panel.
123-
1. Click the cog icon in the upper right of the panel.
122+
1. Click on the SLO to open the details side panel.
123+
1. Click the cog icon in the upper right of the panel.
124124
1. Select **Permissions**.
125125
1. Click **Restrict Access**.
126126
1. The dialog box updates to show that members of your organization have **Viewer** access by default.
@@ -135,7 +135,7 @@ To maintain your edit access to the SLO, the system requires you to include at l
135135

136136
## Searching SLOs
137137

138-
The [Service Level Objectives status page][2] lets you run an advanced search of all SLOs so you can find, view, edit, clone or delete SLOs from the search results.
138+
The [Service Level Objectives manage page][2] lets you run an advanced search of all SLOs so you can find, view, edit, clone or delete SLOs from the search results.
139139

140140
Advanced search lets you query SLOs by any combination of SLO attributes:
141141

@@ -161,13 +161,27 @@ Sort SLOs by the *status* and *error budget* columns to prioritize which SLOs ne
161161

162162
### SLO tags
163163

164-
SLO tags can be used for filtering on the [SLO status page][2], creating [SLO saved views][17], or grouping SLOs to view. Tags can be added to SLOs in the following ways:
164+
SLO tags can be used for filtering on the [SLO manage page][2], creating [SLO saved views][17], or grouping SLOs to view. Tags can be added to SLOs in the following ways:
165165

166166
- When you create or edit an SLO, you can add tags
167167
- From the SLO list view, you can add and update tags in bulk using the *Edit Tags* and the *[Edit Teams][18]* dropdown options at the top of the SLO list.
168168

169169
{{< img src="service_management/service_level_objectives/slo_bulk_tag.png" alt="SLO list page displays the Edit Tag dropdown for bulk tag editing" >}}
170170

171+
### SLO burn rate indicator
172+
173+
Burn rate indicators use a rolling 2-hour window to evaluate which SLOs are consuming their error budget too quickly. Burn rate indicators appear next to the applicable SLO names on the [SLO manage page][2].
174+
175+
{{< img src="/service_management/service_level_objectives/slo_burn_rate_indicator.png" alt="The SLO manage page in Datadog. A red icon appears next to the name of an SLO in the list. Mousing over the red icon displays a modal with further information, a burn rate visualization, and a link to the SLO's corresponding service page." style="width:80%;" >}}
176+
177+
There are two possible indicator types:
178+
- A red icon indicating a critical burn rate above 6 in the past 2 hours.
179+
- A yellow icon indicating an elevated burn rate between 1 and 6 in the past 2 hours.
180+
181+
A visual chart accompanies each indicator to show where the burn rate falls relative to the elevated and critical thresholds, allowing quick assessment of the severity.
182+
183+
SLOs can be filtered by burn rate status: Critical, Elevated, and Healthy. For SLOs with a service tag, each burn rate indicator includes a direct link to the related service page for further investigation.
184+
171185
### SLO default view
172186

173187
The default SLO view is loaded when you land on the SLO list view.
@@ -258,11 +272,11 @@ With [Event Monitors][28], you can set up notifications to track SLO audit event
258272
Learn without cost on real cloud compute capacity and a Datadog trial account. Enroll today to learn more about building Dashboards to track SLOs.
259273
{{< /learning-center-callout >}}
260274

261-
After creating your SLO, you can visualize the data through Dashboards and widgets.
275+
After creating your SLO, you can visualize the data through Dashboards and widgets.
262276
- Use the SLO widget to visualize the status of a single SLO
263277
- Use the SLO List widget to visualize a set of SLOs
264-
- Graph 15 months' worth of metric-based SLO data with the [SLO data source][20] in both timeseries and scalar (query value, top list, table, change) widgets.
265-
278+
- Graph 15 months' worth of metric-based SLO data with the [SLO data source][20] in both timeseries and scalar (query value, top list, table, change) widgets.
279+
266280
For more information about SLO Widgets, see the [SLO widget][21] and [SLO List widget][22] pages. For more information on the SLO data source, see the guide on how to [Graph historical SLO data on Dashboards][20].
267281

268282
## SLO status corrections
@@ -277,7 +291,7 @@ When you apply a correction, the time period you specify is dropped from the SLO
277291
- For metric-based SLOs, all good and bad events in the correction window are not counted.
278292
- For Time Slice SLOs, the correction time window is treated as uptime.
279293

280-
You have the option to create one-time corrections for ad hoc adjustments, or recurring corrections for predictable adjustments that occur on a regular cadence. One-time corrections require a start and end time, while recurring corrections require a start time, duration, and interval. Recurring corrections are based on [iCalendar RFC 5545's RRULE specification][24]. The supported rules are `FREQ`, `INTERVAL`, `COUNT`, and `UNTIL`. Specifying an end date for recurring corrections is optional in case you need the correction to repeat indefinitely.
294+
You have the option to create one-time corrections for ad hoc adjustments, or recurring corrections for predictable adjustments that occur on a regular cadence. One-time corrections require a start and end time, while recurring corrections require a start time, duration, and interval. Recurring corrections are based on [iCalendar RFC 5545's RRULE specification][24]. The supported rules are `FREQ`, `INTERVAL`, `COUNT`, and `UNTIL`. Specifying an end date for recurring corrections is optional in case you need the correction to repeat indefinitely.
281295

282296
For either type of correction, you must select a correction category that states why the correction is being made. The available categories are `Scheduled Maintenance`, `Outside Business Hours`, `Deployment`, and `Other`. You can optionally include a description to provide additional context if necessary.
283297

@@ -314,13 +328,13 @@ To view, edit, and delete existing status corrections, click on the **Correction
314328

315329
#### Visualizing status corrections
316330

317-
For Metric-based and Time Slice SLOs with status corrections, there is a toggle in the SLO detail view that lets you enable or disable corrections in the UI. The toggle controls the charts and data in the "History" section of the SLO detail view. **Note:** Your overall SLO status and error budget will always take status corrections into consideration.
331+
For Metric-based and Time Slice SLOs with status corrections, there is a toggle in the SLO detail view that lets you enable or disable corrections in the UI. The toggle controls the charts and data in the "History" section of the SLO detail view. **Note:** Your overall SLO status and error budget will always take status corrections into consideration.
318332

319333
{{< img src="service_management/service_level_objectives/correction-toggle.png" alt="SLO correction UI" style="width:100%;">}}
320334

321335
## SLO calendar view
322336

323-
The SLO Calendar View is available on the [SLO status page][2]. On the top right corner, switch from the "Primary" view to the "Daily", "Weekly", or "Monthly" view to see 12 months of historical SLO status data. The Calendar View is supported for Metric-based SLOs and Time Slice SLOs.
337+
The SLO Calendar View is available on the [SLO manage page][2]. On the top right corner, switch from the "Primary" view to the "Daily", "Weekly", or "Monthly" view to see 12 months of historical SLO status data. The Calendar View is supported for Metric-based SLOs and Time Slice SLOs.
324338

325339
{{< img src="service_management/service_level_objectives/slo-calendar-view-2.png" alt="SLO calendar view" >}}
326340

@@ -330,7 +344,7 @@ The SLO Calendar View is available on the [SLO status page][2]. On the top right
330344
The CSV Export feature is in Preview. Complete the form to request access.
331345
{{< /callout >}}
332346

333-
The SLO CSV Export feature is available on the [SLO status page][2] once you switch to the "Weekly" or "Monthly" Calendar View. In these views, you can access the new "Export to CSV" option to download a CSV of your historical SLO data with the following information:
347+
The SLO CSV Export feature is available on the [SLO manage page][2] once you switch to the "Weekly" or "Monthly" Calendar View. In these views, you can access the new "Export to CSV" option to download a CSV of your historical SLO data with the following information:
334348

335349
- SLO id, name, and type
336350
- SLO tags
179 KB
Loading

0 commit comments

Comments
 (0)