Monitor Status

Overview

After creating your monitor, use the monitor status page to view the status over time.

monitor status page

The header contains the monitor’s status, time of status, and monitor title. On the right are the Mute, Resolve, and settings cog buttons.

Mute

Use the mute button to mute the entire monitor or partially mute it by setting a Scope. The available scopes are based on the monitor’s group tags. See Downtimes for details on muting multiple scopes or monitors at the same time.

Note: Muting or unmuting a monitor with the UI deletes all scheduled downtimes associated with that monitor.

Resolve

If your monitor is in an alert state, the Resolve button is visible. Use this button to resolve your monitor manually.

The monitor resolve function is artificially switching the monitor status to OK for its next evaluation. The next monitor evaluation is performed normally on the data the monitor is based on.

If a monitor is alerting because its current data corresponds to the ALERT state, resolve has the monitor follow the state switch ALERT -> OK -> ALERT. Therefore, using resolve is not appropriate for acknowledging the alert or telling Datadog to ignore the alert.

Manually resolving a monitor is appropriate for cases where data is reported intermittently. For example, after triggering an alert the monitor doesn’t receive further data so it can no longer evaluate alerting conditions and recover to the OK state. In that case, the resolve function or the Automatically resolve monitor after X hours changes the monitor back to an OK state.

Typical use case: A monitor based on error metrics that are not generated when there are no errors (aws.elb.httpcode_elb_5xx, or any DogStatsD counter in your code reporting an error only when there is an error).

Create an incident

Create an incident from a monitor by selecting Declare incident. Configure the Declare Incident pop-up modal with the severity level, notifications, and additional notes. For more information, see the Incident Management documentation.

Settings

Click the settings cog to display the options available:

OptionDescription
EditEdit the current monitor. See details in the Configure Monitors section.
CloneMake a copy of the current monitor.
ExportExport the JSON configuration for the current monitor. This option is also available when creating your monitor. If you manage monitors programmatically, define a monitor in the UI and export the JSON.
DeleteDelete the current monitor. You will be prompted to confirm the deletion.

Properties

The properties section is the overview of your monitor’s:

PropertyDescription
StatusAlert, Warn, No Data, or OK
TypeLearn more about monitor types.
IDUsed for the monitor API.
Date createdThe date the monitor was created.
AuthorThe person who created the monitor.
TagsThe tags attached at the monitor level. Edit the tags by clicking on the pencil icon.
QueryLearn more about querying.
MessageThe message specified in the notification section of the monitor.

Status and history

The status and history section displays the query and state changes of your monitor over time. To filter the information, use the search box, statuses, and time selector above the section.

Status

The status graph shows your monitor’s status over time, broken out by group. Note: If you see None or no groups found, one of the following situations may apply:

  • The monitor is newly created and has not evaluated yet.
  • The monitor’s query was recently changed.
  • The monitor’s timeframe is too short for a metric that provides data infrequently.
  • A host’s name previously included in the query has changed. Hostname changes age out of the UI within 2 hours.
  • The query you are filtering by is not working as expected.

The status graph shows you the dimensions you configured for your alerts, not the dimensions in your monitor query. For example: your monitor query is grouped by service and host, but you only want to receive alerts for the service. The status graph shows the monitor’s status grouped by service. You can see the host subgroups by clicking View all which opens a panel showing status graphs for each subgroup. For more information on alert groupings, see Configure Monitors.

Monitor status grouped by service, highlighting option to view subgroups

Filter the monitor status by groups or events

To scope down the Status & History view to specific groups, use the filter field and enter the attributes you want to filter by. The group filter syntax follows the same principles of the Monitor Search query. Some best practices to follow:

  • Filters are case sensitive, env:prod and env:Prod do not return the same monitor groups. Datadog recommends practicing uniformity in tags. For more information, see Getting Started with Tags.

  • Queries automatically append a wildcard. To apply specific filters, surround your query with double quotes ("). For example, take the following query which does not use double quotes:

    availability-zone:us-central1-a,instance-type:*,name:gke-demo-1
    

    The monitor returns the follow groups even though you expect the query to show one specific group.

    availability-zone:us-central1-a,instance-type:*,name:gke-demo-10
    availability-zone:us-central1-a,instance-type:*,name:gke-demo-12
    

    Surrounding the query with double quotes returns the expected group: "availability-zone:us-central1-a,instance-type:*,name:gke-demo-1"

Investigate a Monitor in a Notebook

For further investigation into your metrics evolution, click Open in a notebook by the status graph. This generates an investigation notebook with a formatted graph of the monitor query.

Open in notebook button

The notebook matches the monitor evaluation period time range and includes related logs where relevant.

History

The history graph shows the collected data aligned with the status graph. It shows the raw data points being submitted for the metric query in the monitor. The monitor status page uses the same timeseries graph widget that is used in Notebooks and Dashboards.

Evaluation graph

The evaluation graph is specific to the monitor. It uses the same query logic as the history graph, however it is scoped to the timeframe bracket on the history graph. It has a fixed, zoomed window that corresponds to your monitor evaluation window to ensure the displayed points are aggregated correctly. For example, if the monitor is configured to evaluate the average of the query over the last 15 minutes, each datapoint in the evaluation graph shows the aggregate value of the metric for the previous 15 minute evaluation window.

This graph shows the results from the raw data points of a metric applied against the evaluation conditions you configure in the monitor. This visualization is different from the History graph because it’s showing the value of the data after it has gone through the monitor query.

Events

Events generated from your monitor (alerts, warnings, recoveries, etc.) are shown in this section based on the time selector above the Status & History section. The events are also displayed in your Events Explorer.

Audit events

For all monitor types, monitor changes (monitor edits for instance) create an event in the Events Explorer. This event explains the change and displays the user that made the change. For more information, see the Events documentation.

If you made changes to a monitor, you can see examples with the following event search:

https://app.datadoghq.com/event/stream?per_page=30&query=tags%3Aaudit%20status%3Aall%20priority%3Aall%20monitor%20modified

Datadog also provides a notification option for changes to monitors you create. At the bottom of the monitor editor, under Define permissions and audit notifications, select Notify in the dropdown next to: If this monitor is modified, notify monitor creator and alert recipients..

The notify setting sends an email with the monitor audit event to all people who are alerted in the specific monitor as well as to the monitor creator. The monitor audit event also appears in the Events Explorer.

Export and import

You can obtain a JSON export of any monitor from the monitor’s status page. Click the settings cog (top right) and choose Export from the menu.

Import a monitor to Datadog with JSON using the main navigation: Monitors –> New Monitor –> Import.

Further Reading