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

Analysis Monitor

This product is not supported for your selected Datadog site. ().

Overview

Analysis monitors offer full access to Notebook analysis and DDSQL features, allowing you to alert on complex data patterns that standard monitors may miss. With Analysis monitors, you can:

  • Query multiple data sources
  • Chain data transformations
  • Run complex SQL queries
  • Create sophisticated analysis workflows

Supported data sources

Analysis monitors support a subset of the data sources available in Notebook Analysis cells and DDSQL queries. Because monitors evaluate their queries frequently, each data source is enabled only after it’s validated to handle monitor-level query load.

The following data sources are supported:

  • Audit
  • CI Pipelines
  • CI Tests
  • Events
  • Agent Observability
  • Logs
  • Metrics
  • NetFlow
  • Network
  • Reference Tables
  • RUM
  • Service Checks
  • Spans

Published analyses are supported only when every data source they depend on is also supported.

The following data sources are not supported:

  • Dora Metrics
  • Flex Logs
  • Infrastructure Resources

If you select a published analysis built on an unsupported data source, Datadog displays an error that names the source. For example:

Analysis is based on an unsupported datasource for monitoring: Infrastructure Resources

Monitor creation

You can create an Analysis monitor in three ways:

From the Monitors page

To create an Analysis monitor in Datadog, use the main navigation: Monitors > New Monitor > Analysis.

From a Notebook

To create an Analysis monitor directly from a Notebook:

  1. Open a Notebook with an Analysis cell containing your desired query.
  2. In the Analysis cell, click Send To.
  3. Select Monitors.

This allows you to convert your exploratory analysis into an alerting monitor.

From the DDSQL Editor

To create an Analysis monitor directly from the DDSQL Editor:

  1. Open the DDSQL Editor and select your desired query.
  2. Click the dropdown arrow next to Save to dashboard.
  3. Select Create monitor.

Define the query

  1. Select your published analysis: Select from available Notebook or DDSQL published analyses.
  2. Filter your published analysis: Filter your results by column.
  3. Preview results: View the output of your query before setting alert conditions.
Analysis monitor configuration example

Set alert conditions

Configure monitors to trigger when the query value crosses a threshold, and customize advanced alert options such as recovery thresholds and evaluation delays. For more information, see Configure Monitors.

Notifications

For detailed instructions on alert messaging, see Notifications.

Further reading