VOOZH about

URL: https://docs.datadoghq.com/synthetics/notifications/

⇱ Synthetic Monitoring Notifications


For AI agents: A markdown version of this page is available at https://docs.datadoghq.com/synthetics/notifications.md. A documentation index is available at /llms.txt.

Synthetic Monitoring Notifications

Overview

Customize your alerts in Synthetic Monitoring to give on-call responders meaningful context. Synthetic Monitoring’s message templating system lets you enrich alerts with test details, extract data from test results, and route notifications conditionally based on the failure.

Synthetic Monitoring notifications are not supported in your Continuous Testing CI/CD pipelines.

Pre-filled monitor messages

Synthetic Monitoring provides pre-filled messages with no setup required; each alert includes the test name, failing locations, a link to the result, and metadata such as:

  • Test name
  • Monitor ID
  • Failing locations
  • Last failed test run information
  • Time the test started failing

These values appear automatically in most notification channels without any configuration.

To include additional test result data beyond the defaults, use handlebar formatting in your monitor message.

Display custom notifications message

Synthetic Monitoring notifications support the ability to display only the custom notification message in alert notifications, hiding all default enriched content such as query details, tags, screenshots, and footers.

By default, all monitors include enriched details in the alert message. This may include:

  • Test metadata
  • Failing step information
  • Screenshots
  • Tags
  • Links to Datadog resources

Notification presets

Use presets to control which content appears:

PresetWhat it showsWhen to use it
show_allAll enriched data, metadata, and handlesDefault; best for email and ticketing channels
hide_handlesAll enriched data, but hides @notification handles (for example, @slack-channel)Prevents duplicate pages when a channel is already notified at the monitor level
hide_allCustom message and event link onlyChat channels where you control the full message format

See Monitor Notifications for more information.

Simulate notifications

You can test your notification messages by sending simulated notifications. To do this:

  1. Add a notification handle to your monitor message
  2. Click the Simulate Notifications button:
  1. Select the notification type you want to test and click Send:

Simulated notifications include [TEST] in their subject lines and use a default monitor name when needed.

Examples:

Important notes about simulated notifications:

  • The test results used in simulations are standardized sample data, not actual results from your specific test configuration.
  • Results vary based on test type, subtype (for API tests), and notification type:
    • Alert notifications: Simulated failure data
    • Recovery notifications: Simulated success data
  • All users receive the same simulated data regardless of their test setup.

Next steps

Further Reading