Network Performance Monitoring is now generally available! Network Monitoring is now available!

Downtimes

Schedule downtimes for system shutdowns, off-line maintenance, or upgrades without triggering your monitors.

What happens to a monitor when it is muted (or has a scheduled downtime)?

You can schedule downtimes and/or mute your Datadog monitors so that they do not alert at specific times when you do not want them to.

Monitors trigger events when they change state between ALERT, WARNING (if enabled), RESOLVED, and NO DATA (if enabled). If a monitor has been silenced either by a downtime or muting, then any transition from RESOLVED to another state does not trigger an event or notifications.

Note: Muting or un-muting a monitor with the UI does not delete scheduled downtimes associated with that monitor. For that, use the Manage Downtimes feature or the API.

If a monitor transitions states during a downtime (such as from OK to ALERT, WARNING, or NO DATA) and remains in that state once a scheduled downtime expires, it does NOT trigger a notification. However, it does trigger a recovery event once data returns for that scope or the monitor returns to an OK state.

This behavior is designed to prevent spammy NO DATA state alerts when using the Autoresolve feature. If you would prefer that the monitor trigger a NO DATA state event at the time that the silencing expires, reach out to the Datadog support team to request that this feature is enabled for your account. This only affects instances when a monitor exits a downtime period in a NO DATA state.

If a monitor triggers an alert before a downtime and recovers during that downtime, then a recovery event is sent during the downtime (if this is the first recovery during that downtime).

Monitor report

All alerted states are included on the weekly monitor report even if the monitor is in a downtime.

Manage Downtime

Navigate to the Manage Downtime page by hovering over Monitors in the main menu, then select Manage Downtime.

The Manage Downtime page displays a list of active and scheduled downtimes. Select a downtime to view more details about the host and monitors affected.

Schedule Downtime

To schedule downtime, click the “Schedule Downtime” button in the upper right.

  1. Choose what to silence.

    Silencing by monitor name You must select at least one monitor. If you choose to leave the selection field empty, all monitors are silenced by default. You can also select a scope to constrain your downtime to a specific host, device, or arbitrary tag. Refer to the scope section of the Graphing Primer using JSON for further information about scope. Silencing by monitor tags You can select one or more monitor tags to schedule downtimes on, but you must select at least one using this method. There is a limit of 32 tags, and each tag can be at most 256 characters long. Only monitors that have ALL selected tags are silenced. You can also select scopes for additional constraints.

    For either method, if you choose to silence all monitors constrained by a scope, clicking Preview affected monitors shows which monitors are affected. Any monitors within your scope that are created or edited after the downtime is scheduled are also silenced. Note that if a multi-alert is included, it is only silenced for groups covered by the scope. For example, if a downtime is scoped for host:X and a multi-alert is triggered on both host:X and host:Y, Datadog generates a monitor notification for host:Y, but not host:X.

  2. Set a schedule.

    You can set a start date and time or leave the field empty to immediately start the downtime. You may also set a repeating schedule to accommodate regularly scheduled downtimes.

  3. Add an optional message to notify your team

    Enter a message to notify your team about this downtime. The message field allows standard markdown formatting as well as Datadog’s @-notification syntax. The Notify your team field allows you to specify team members or send the message to a service integration.

Note: Create the downtime before you create the monitor or before you mute the group.

Recurring Downtimes

Recurring downtimes allow you to create a downtime that is started and stopped at a recurring interval or pattern.

One use case for this would be if you have regularly scheduled maintenance windows and want to suppress what might become a noisy monitor due to your changes.

When a recurring downtime ends, the downtime is cancelled and a new downtime with the same constraints (with updated start and end times) is created in a rolling pattern.

Note: The original creator is associated to all of these newly created downtimes.

Searching Downtimes

Downtime history can be seen both on the Monitor Status Page as overlaid on the group transition history, as well as in the Event Stream by searching for tags:audit,downtime, or a specific downtime by ID with tags:audit,downtime_id:<DOWNTIME_ID>

Further Reading