Documentationbreadcrumb arrow Pluginsbreadcrumb arrow Datadog data sourcebreadcrumb arrow Annotations
Enterprise Grafana Cloud
Last reviewed: June 2, 2026

Datadog annotations

Annotations overlay event markers on a dashboard’s graphs, so you can correlate Datadog events with your visualized data. The Datadog data source builds annotations from the Datadog event stream using an Events query.

For an introduction to annotations, refer to Annotations.

Add a Datadog annotation query

To add an annotation query that uses the Datadog data source, complete the following steps:

  1. Open your dashboard and go to Dashboard settings.
  2. Click Annotations in the sidebar menu.
  3. Click Add annotation query.
  4. Enter a name for the annotation.
  5. Select your Datadog data source from the Data source drop-down.
  6. Configure the query fields.
  7. Click Save dashboard.

Annotation query fields

The Datadog annotation editor returns recent events from the Datadog event stream, filtered to the dashboard’s time range. Configure the following fields:

  • Sources - Enter a comma-separated list of sources to filter the events in the query.
  • Tags - Enter a comma-separated list of tags to filter the events in the query.
  • Priority - Select the priority of the events to return. Options are None, Low, or Normal.

Note

Datadog annotation queries use the same underlying API as the Events query type and return a maximum of 1000 of the most recent events. For more information, refer to Event Management in the Datadog documentation.

Example: overlay deployment events

To mark production deployments on your dashboard graphs, configure an annotation query that filters the event stream to deployment events:

  1. In Dashboard settings > Annotations, click Add annotation query and select your Datadog data source.
  2. In Sources, enter the source that emits your deployment events, such as github or ci.
  3. In Tags, enter env:production to limit the events to your production environment.
  4. Leave Priority set to None to return events of any priority.
  5. Click Save dashboard.

Each matching deployment event appears as a vertical marker on the dashboard’s time-series panels. Hover over a marker to view the event title and description.