Upgrade Synthetic Monitoring
- Latest Dynatrace
- Explanation
- 3-min read
If you already run Synthetic Monitoring in a Dynatrace Classic environment, upgrading to the latest Dynatrace touches every layer of your setup, from how monitors and locations are represented, to how maintenance windows behave, to how dashboards and access rules are configured. Work through this upgrade guide with its sub-pages to complete the upgrade.
Before you begin
Prerequisites
DPS license
Synthetic Monitoring requires a Dynatrace Platform Subscription (DPS) license. If you are on a Classic license, contact your Dynatrace account team before proceeding.
Permissions
| Permission area | What you need |
|---|---|
Settings |
|
Data access |
|
App access |
|
Scope
This upgrade guide covers the following Synthetic Monitoring components:
| Component | Coverage |
|---|---|
Browser monitors | Fully covered: activate the latest RUM JavaScript per monitor or at environment level. |
HTTP monitors | Fully covered: entity references and maintenance windows must be updated. |
Network availability monitors (NAM) | Fully covered: custom-device target filters must be replaced with IP addresses or hostnames. |
Third-party Synthetic integrations | Covered: each active integration requires a replacement path (native NAM or external-test ingest). |
Private locations | Fully covered: update Synthetic Engines to version 1.347+. Kubernetes and OpenShift locations also require redeployment or Synthetic metric adapter migration. |
What changes
| Classic concept | Target concept in latest Dynatrace |
|---|---|
Classic Synthetic entity | Smartscape Synthetic node |
Classic Synthetic metrics and events | Metrics and events in Grail |
Management zone used for access | IAM policy with a security-context boundary |
Management zone used for filtering | Segment or equivalent DQL filter |
Classic access token | Platform token for user-context access, or OAuth client for service-to-service automation |
Check your upgrade readiness
Use the Check your upgrade readiness dashboard to see the current state of your Synthetic setup before and during the upgrade.
To open the dashboard, go to 
Dashboards > All dashboards > Ready-made and select Check your upgrade readiness.
The Synthetic monitoring section of the dashboard covers:
- Browser monitors: shows the status of each browser monitor:
- Not migrated: the monitor still reports to Classic only. Enable the Browser monitors on latest Dynatrace setting for it.
- Migrated with a duration difference, for example +12.4%: the monitor reports to latest Dynatrace, and its duration differs from Classic. Review the difference and adjust thresholds if needed.
- Migrated: the monitor reports to latest Dynatrace.
- Monitor disabled: the monitor is turned off and doesn't run.
- NAM monitors: lists network availability monitors that use custom-device target filters and need to be updated.
- Private Synthetic locations: shows engine versions per location and highlights engines below version 1.347.
- Performance thresholds: compares Classic and Grail durations for monitors with performance thresholds, so you can identify and adjust thresholds before Classic monitoring becomes unavailable.
Treat the readiness dashboard as an inventory aid, not as proof that the upgrade is complete. An empty result can mean that no recent data was found; it does not replace configuration inspection and execution tests.
Upgrade your Synthetic Monitoring setup
Follow the steps below in the order listed. Each page ends with a Verify the upgrade section. The upgrade is complete when every applicable page has passed its verification.