Try it free

Upgrade dashboards

  • Latest Dynatrace
  • Upgrade guide
  • Published Jul 24, 2026

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 metrics 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.

Why upgrade?

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.

  • Query-based dashboards: metrics, logs, and traces accessible with full DQL flexibility and interactive filtering, replacing static tiles and management zone constraints

What will you do?

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.

  1. Identify and prioritize classic dashboards to upgrade
  2. Run the built-in dashboard converter on selected dashboards
  3. Review, fix, and rebuild unconverted tiles and filters manually
  4. Validate upgraded dashboards and decommission classic versions

Before you begin

At a glance

  • Estimated effort: 3–15 days
  • Estimated timeline: 1–6 weeks

Prerequisites

Upgrade configurations and settings

Key stakeholders

RoleInvolvementResponsibility
Dynatrace AdminRequiredRuns the converter and manages dashboard permissions
Application Team LeadsRecommendedValidate that their upgraded dashboards display accurate data
Dashboard OwnersRecommendedConfirm that converted tiles, filters, and variables match original intent

Upgrade dashboards

1. Identify and prioritize dashboards to upgrade

Use dashboard usage data and team input to prioritize which classic dashboards to migrate, focusing effort on the highest-value content first.

  1. Pull the full list of all classic dashboards from Dynatrace settings.
  2. Use popularity metrics (view count, owner, last modified) to rank dashboards by active use.
  3. Work with team leads to confirm which dashboards are actively relied on for operations.
  4. Mark dashboards that are unused or duplicates as candidates for decommissioning without migration.
  5. Create a prioritized migration list ordered by business criticality.

Verify: Migration priority list agreed upon by all relevant team leads before conversion begins.

2. Run the built-in dashboard converter

Use the out-of-the-box conversion tool to auto-migrate supported dashboard tiles to Latest Dynatrace.

  1. Open each prioritized classic dashboard and run the built-in converter.
  2. Review the conversion summary: note which tiles were converted and which were skipped.
  3. Save the converted dashboard as a new Latest Dynatrace dashboard without overwriting the classic version.
  4. Repeat for all dashboards in the prioritized migration list.

Verify: All prioritized dashboards processed through the converter with conversion summaries documented.

3. Review and rebuild unconverted tiles and filters

Identify gaps from auto-conversion, recreate unsupported tiles using DQL, and configure dashboard variables to replace classic filters.

  1. For each converted dashboard, review all tiles the converter skipped or flagged as requiring manual attention.
  2. Recreate USQL tiles as DQL-based query tiles with equivalent output.
  3. Rebuild custom chart tiles using the Latest Dynatrace DQL-based visualization options.
  4. Rebuild management zone filters as Latest Dynatrace dashboard variables scoped to the appropriate segment.
  5. Replace classic markdown tiles with Latest Dynatrace text tiles or callout components.

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.

4. Validate and decommission classic dashboards

Confirm that each team's upgraded dashboards display accurate data, then archive classic versions.

  1. Share each upgraded dashboard with its owner and team leads for review.
  2. Ask each team to verify that key metrics, time-series data, and filter behavior match operational expectations.
  3. Address any discrepancies identified during review.
  4. Once a team confirms their dashboard, archive or hide the classic version.
  5. Track the ratio of upgraded vs. remaining classic dashboards until target coverage is reached.

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:

  • Target percentage of actively used classic dashboards are upgraded and validated by their owner teams
  • All unconverted tiles are rebuilt manually and management zone filters are replaced with segment-scoped dashboard variables
  • Classic dashboard versions are archived after team confirmation

This stage runs in parallel with Upgrade metrics alerting and maintenance windows; both must be complete before continuing. Once both are done, continue to Upgrade team-based and global alerting.

Documentation and best practices

The following resources support your work in this stage.

  • Upgrade from Dashboards Classic to Dashboards

    Complete guide for migrating classic dashboards to Latest Dynatrace, including how to use the built-in converter.

Ready for more?

This stage runs in parallel with Upgrade metrics alerting and maintenance windows; both must be complete before moving forward. Continue to stage 9: Upgrade team-based and global alerting.

Related tags
Dynatrace Platform