Use the monitor uptime widget to track your monitor’s uptime via a widget in your screenboards. Monitor 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).
To configure the widget from a screenboard:
Select the monitor to display uptime for.
Optionally - Select the monitor group ordering between the worst performing 5 groups, best performing 5 groups, or custom (select up to 5 custom groups).
The total percentage is based on the worst state of any group, which when selected by group can be calculated based on the entire monitor or scoped by the selected groups.
If the widget is configured to report by groups, only one duration can be selected; otherwise, select up to 3 uptime durations for your widget from:
For the 7 days option, the widget is restricted to 1 decimal place of accuracy. For 30 days and up, the widget is restricted to 2 decimal places of accuracy.
Select the conditional formatting based on the uptime percentage: red (down) / green (up) / yellow (warn).
To finish the configuration, give a title to your widget and save it to your screenboard.
If the chosen monitor for the widget is configured to alert on WARN or NO DATA, those states are rendered as down (red) inside the uptime widget.
Downtimes and muted periods are disregarded: if your monitor triggers during a scheduled downtime, that period is removed from the calculated uptime.
To ensure accurate calculations, new monitors aren’t calculated until the end of the first UTC day. Until the first UTC day is over, a warning message is displayed instead:
While the widget is in private beta, Datadog engineering teams are working through the final implementation. Thus, until the end of the beta phase, do not rely on the uptime percentage. Should you see any discrepancies or unexpected behaviors, reach out to the Datadog support team.
Additional helpful documentation, links, and articles: