Maintenance windows go through three phases: start, active, and end. Each phase triggers actions in Grail and OpenPipeline that enrich telemetry with maintenance metadata.
At the start and end of a maintenance window, Dynatrace creates an event in Grail.
While a maintenance window is active, Dynatrace automatically adds maintenance metadata to metrics and specific events that match the window's DQL filter criteria. This metadata flags data produced during maintenance.
Maintenance enrichment provides a consistent context across the Dynatrace platform. Use it to filter dashboards, refine alerting rules, adjust workflow logic, and improve reporting and availability calculations.
| Phase | What happens |
|---|---|
Start | Dynatrace records a maintenance window start event in Grail and creates an OpenPipeline enrichment rule. |
Active | Incoming telemetry matching the window's filter criteria is enriched with maintenance attributes. |
End | Dynatrace records a maintenance window end event in Grail and removes the OpenPipeline rule. Enrichment stops. |
Start and end events are aggregated into the dt.maintenance.windows view for querying.
The maintenance attributes are present in telemetry only while the window is active. Telemetry ingested before or after the window isn't enriched.
When a maintenance window starts, Dynatrace:
The start event is written to Grail as a generic event and includes maintenance window metadata.
The start event includes the following maintenance window details:
maintenance_window.title) and description (event.description)maintenance_window.filter)start_time and end_time)dt.settings.object_id)maintenance_window.instance_id)maintenance_window.owner)The OpenPipeline rule applies an enrichment processor to the data pipelines for metrics and specific events. The rule uses the DQL filter criteria you defined to match telemetry and adds the maintenance attributes to any matching data.
The rule exists only for the active duration of the window. When the window ends, Dynatrace removes the rule, and no new telemetry is enriched.
While the window is active, incoming telemetry that matches the filter criteria is enriched with the following attributes:
| Data type | Enrichment attributes |
|---|---|
Metrics |
|
Davis events |
|
Smartscape events |
|
Synthetic events and sessions |
|
Only data that matches the DQL filter criteria is enriched.
When a maintenance window ends, Dynatrace:
From this point, telemetry ingested into matching pipelines no longer receives any maintenance attributes.