SLO Summary Widget

Setup

Use the SLO Summary widget to visualize a Service Level Objective (SLO) on a dashboard.

Configuration

1. On the dashboard page, add an SLO Summary widget.
2. Select an SLO from the dropdown menu.
3. Select up to three different time windows.

Note: The Global Time allows you to display your SLO’s status and error budget over arbitrary time periods within the past 90 days. Additionally, you can specify an optional unique SLO target for the arbitrary time period. Specifying an SLO target is required to display an error budget and for being able to color code the SLO status value as green or red. If no SLO target is specified only the SLO status is shown and the font color remains gray.

Options

Display preferences

Select whether to show or hide remaining error budget by toggling the Show error budget option. If you are visualizing a monitor-based SLO with multiple groups or multiple monitors, select your View mode:

• For monitor-based SLOs configured with a single monitor broken into multiple groups, there are the following three view modes:

  • Status: displays the overall SLO status percentages and targets
  • Groups: displays a table of status percentages for each group
  • Both: displays both the overall SLO status percentages and targets and table of status percentages for each group

• For monitor-based SLOs configured with multiple monitors, there are the following three view modes:

  • Status: displays the overall SLO status percentages and targets
  • Monitors: displays a table of status percentages for each monitor
  • Both: displays both the overall SLO status percentages and targets and table of status percentages for each monitor

Note: When the Global Time time window option is selected you can only use the Status view mode.

Title

Display a custom title for your widget by checking the Show a title check box:

You can optionally define the title’s size and alignment.

API

This widget can be used with the Dashboards API. See the Dashboards API documentation for additional reference.

The dedicated widget JSON schema definition for the SLO Summary widget is:

{
  "global_time_target": "string",
  "show_error_budget": false,
  "slo_id": "string",
  "time_windows": [],
  "title": "string",
  "title_align": "string",
  "title_size": "string",
  "type": "slo",
  "view_mode": "string",
  "view_type": "detail"
}

Further Reading

Additional helpful documentation, links, and articles:

Track the status of all your SLOs in DatadogBLOG