Join us at the Dash conference! July 16-17, NYC

SLO Widget

monitor uptime widget

Use the SLO and uptime widget to track your SLOs (Service Level Objectives) and uptime on screenboards and timeboards.

Uptime is defined as the amount of time a monitor was in an up state (OK) compared to down state (non-OK). Similar to the monitor status page visualization, the status is represented in bars as green (up) and red (down). Example: 99% of the time latency is less than 200ms.

You can also track success rate and event-based SLIs (Service Level Indicators). Example: 99% of requests are successful.

Widget configuration for timeboards or screenboards

Selecting your data for monitor uptime

Choose a monitor

Monitor uptime is available under the time-based SLI dropdown in the widget. This lets you know how much time something spent in an OK state.

Choose a monitor

First, select a monitor.

Optionally, you can view uptime by monitor groups in three different ways:

  • Worst performing 5 groups
  • Best performing 5 groups
  • Custom (select up to 20 groups)

You can view the uptime percentage for the overall monitor, by selected groups, or both. For calculation, the total uptime percentage when selected by group can be calculated, as well as on the total of the monitors (all groups regardless of what’s selected) or for only the selected groups.

Note: The overall uptime value represents the proportion of time that none of the groups in the widget’s scope were in an alert state.

View Mode

You can also query multiple monitors and use the monitor search query to select your specific monitors.

Visually, you can view the overall uptime percentage only—or the overall, plus the uptime for each individual monitor

View Mode

Datadog recommends searching by monitor tags to select multiple monitors. For example, you can select by service: service:a.

You can select up to 20 monitors.

Supported monitor types

Currently only metric monitor types, service checks, and synthetics are supported in the widget. Only supported monitors will be available to select within the widget. All other monitor types are not currently supported.

Supported metric monitor types include: metric, anomaly, APM, forecast, outlier, and integration metrics. For more info, see here for monitor types.

Selecting your time window

Next, select the time window you want to report within.

For single monitors, you can select up to 3 windows. For monitor-by-group or multi-monitor selection, you can only select 1 window. The widget is currently not compatible with Global Time.

Available windows are: 7 days, month-to-date, 30 days (rolling), Previous Month, and 90 days (rolling)

Note: for 7 days, the widget is restricted to 2 decimal places of accuracy. For 30 days and up, it’s restricted to 2-3 decimal places of accuracy.

Setting the conditional formatting

Next, select the conditional formatting based on the uptime percentage. This can be red (down) or yellow (warn).

Save your widget

Finally, give the widget a title and save it to your dashboard.

Show error budget

By default, the widget displays the error budget. The error budget represents the amount of time you are allowed to be in the red until your defined SLO is breached. This is calculated using the value entered into your conditional formatting and the time window selected. If nothing is selected, you will see an error message that states: No Rules Specified. You can change this by editing the widget.

Selecting your data for event SLIs

Toggle to event SLIs.

Choose a source

Select your metrics. You are defining a success rate through numerator and denominator fields.

Select the metrics that represent your successful events in the numerator, and select the metrics that represent your total events in the denominator.

You can add up to as many metrics as you need for both fields and add a formula to calculate the total for each.

Selecting your time window

Next, select the time window you want to report within.

The widget is currently not compatible with Global Time.

Available windows are: 7 days, month-to-date, 30 days (rolling), Previous Month, and 90 days (rolling)

Note: Datadog displays up to 3 decimal places for all time windows.

Setting the conditional formatting

Next, select the conditional formatting based on the uptime percentage. This can be red (down) or yellow (warn).

Save your widget

Finally, give the widget a title and save it to your dashboard.

Feature requests

To submit feature requests, reach out to Datadog Support, and someone from the team will assist you.

Widget behavior

While the widget is in public beta, the documentation is subject to change. Datadog recommends that you currently do not rely on the widget for reporting.

Further Reading

Additional helpful documentation, links, and articles: