Primary Grail tags for Synthetic

• Latest Dynatrace
• Explanation
• Updated on Sep 08, 2026

When configuring a Synthetic monitor of any type, you can apply primary Grail tags to the monitor. After that, all events and metrics generated by the monitor are enriched with these primary Grail tags. Primary Grail tags provide filtering, grouping, and bucket assignment across your Synthetic telemetry. You can retrieve:

Enrichment guidance

Configure primary Grail tags directly on each monitor through the Dynatrace UI or the Synthetic API. This way, tags are added to both the data produced by the monitor and to the Smartscape node that represents the monitor.

UI: Go to Synthetic, select your monitor, select Edit, and then go to Primary Grail tags and add key-value pairs.

API: Use the same monitor configuration endpoint you use to create or update monitors. Include primaryGrailTags in the request body:

{
  "primaryGrailTags": [
    {
      "key": "team",
      "value": "team-payments"
    },
    {
      "key": "environment",
      "value": "production"
    }
  ]
}

Scope and propagation

Primary Grail tags are configured per monitor. At every execution, Dynatrace propagates the monitor's tags to all events and metrics produced by that execution. Tags aren't inherited from the Synthetic location, host group, or any other entity.

Coverage

All three Synthetic monitor types support primary Grail tags.

Limitations

When you apply primary Grail tags to the monitor, keep the following constraints in mind:

Query examples