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

Event monitor

Overview

Event monitors allows you to alert when an event matching your query occurs.

  1. Select the query and parameters (status, priority, sources and tags) you want to monitor:
  2. Select the alert grouping:

  3. Select the alerting conditions. The threshold value and timeframe options allows you to set the number of occurrence of an event required during a timeframe before triggering the monitor.

    Note: Some providers introduce a significant delay between when an event is posted, and when the event actually happened. In this case, Datadog back-dates the event to the time of occurrence, which can lead to odd monitor evaluation behavior. If you observe such behavior, reach out to Datadog Support.

  4. Configure your notification options:
    Refer to the Notifications dedicated documentation page for informations.

Using event tags in Event Monitors

In Event Monitors, you can use the tags sent with events to identify events and customize the actions and messages of the Monitor. First, define the search parameters for the full text event search. If you are looking for a specific tag, you can include this in the search as well. For example:

My Example Event #example-tag

Using event template variables in notifications

Include event-specific information in your event monitor notifications. Available template variables:

Template variable Definition
{{event.id}} ID of the event
{{event.title}} Title of the event
{{event.text}} Text of the event
{{event.host.name}} Hostname that generated the event
{{event.tags.tagname}} Tags attached to the event, replace tagname with the name of your tag.

Use event.tags and event.tags.tagname to retrieve the values of your tags in Markdown. For example:

When your alert triggers, any matching events that are found in Datadog with the tags appear in the message:

Further Reading