The Service Map for APM is here!

Downtimes

You may occasionally need to shut systems down or take them off-line to perform maintenance or upgrades. Scheduling downtime allows you to do this without triggering 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 will neither trigger an event, nor activate any associated notification channels.

Note: Muting or un-muting a monitor via the UI deletes all scheduled downtimes associated with that monitor.

downtime on alert

If a monitor transitions states during downtime (such as from OK to ALERT, WARNING, or NO DATA) and remains in that state once a scheduled downtime expires, it will NOT trigger a notification. However it WILL 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 our support team to request that this feature is enabled for your account. This will only affect instances when a monitor exits a downtime period in a NO DATA state.

Manage Downtime

Navigate to the Manage Downtime page by highlighting the Monitors tab in the main menu and selecting the Manage Downtime link. You may also navigate to the Manage Downtime page from other Monitor related pages by clicking the link at the top of the page.

downtime-nav

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.

downtime-manage

Schedule Downtime

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

  1. Choose what to silence.

    downtime-silence
    You can select a specific monitor to silence, or leave this field empty to silence all monitors. 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. If you choose to silence all monitors constrained by a scope, clicking the Preview affected monitors shows which monitors are currently 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 systems covered by the scope. For example, if a downtime scope is set 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.

    downtime-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

    downtime-notify
    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.

Further Reading