Upgrade actively used classic dashboards to Latest Dynatrace. The built-in dashboard converter handles standard tiles automatically; complex tiles, USQL, and management zone filters require manual recreation.
This stage and Upgrade metric alerting and maintenance windows share the same prerequisite—Upgrade configurations and settings—and can run in parallel once that stage is complete.
Budget for manual tile recreation: enterprise environments with 100+ dashboards require significant manual effort. The built-in converter handles basic tiles, but complex ones need manual DQL recreation. Budget accordingly.
Query-based dashboards unlock precise, cross-signal analysis that static classic dashboards cannot provide: metrics, logs, and traces in a single DQL-driven interface, with segment-scoped filtering replacing management zone constraints.
Prioritization matters here. Enterprise environments with 100+ dashboards cannot migrate everything at once; the built-in converter handles the volume, but manual rebuild time is proportional to dashboard complexity.
Upgrade configurations & settings
| Role | Involvement | Responsibility |
|---|---|---|
Dynatrace Admin | Required | Runs the converter and manages dashboard permissions |
Application Team Leads | Recommended | Validate that their upgraded dashboards display accurate data |
Dashboard Owners | Recommended | Confirm that converted tiles, filters, and variables match original intent |
Use dashboard usage data and team input to prioritize which classic dashboards to migrate, focusing effort on the highest-value content first.
Verify: Migration priority list agreed upon by all relevant team leads before conversion begins.
Use the out-of-the-box conversion tool to auto-migrate supported dashboard tiles to Latest Dynatrace.
Verify: All prioritized dashboards processed through the converter with conversion summaries documented.
Identify gaps from auto-conversion, recreate unsupported tiles using DQL, and configure dashboard variables to replace classic filters.
Verify: All tiles functional with accurate data; dashboard variables replace classic filters with equivalent scope.
Manually recreate unsupported tile types: USQL, custom charts, and markdown tiles are not auto-converted. Each requires manual DQL recreation and can be time-consuming for dashboards with many complex tiles.
Filter migration gap: classic management zone and dropdown filters are not converted automatically. Latest Dynatrace dashboard variables must be rebuilt from scratch, referencing segments instead of management zones.
Confirm that each team's upgraded dashboards display accurate data, then archive classic versions.
Verify: Target percentage of actively used dashboards upgraded to Latest Dynatrace; classic versions archived after team confirmation.
Set response deadlines for team validation: each team must confirm their dashboards before decommissioning classic versions. Set a response deadline for each team to prevent the validation phase from extending indefinitely.
Stage complete when:
This stage runs in parallel with Upgrade metric alerting and maintenance windows; both must be complete before continuing. Once both are done, continue to Upgrade team-based and global alerting.
The following resources support your work in this stage. Documentation covers platform concepts, configuration reference, and related guides; best practice cards provide implementation guidance from Dynatrace experts.
Upgrade from Dashboards Classic to Dashboards
Complete guide for migrating classic dashboards to Latest Dynatrace, including how to use the built-in converter.
Best practices for upgrading dashboards
Prioritize, convert, and validate classic dashboards, and handle unconverted tiles and management zone filter replacements.
This stage runs in parallel with Upgrade metric alerting & maintenance windows; both must be complete before moving forward. Once your dashboards are validated and the parallel alerting stage is done, continue to Upgrade team-based & global alerting.