Migrate to Dashboards (New)

The Migrate to New Dashboards functionality allows you to transform Dashboards (Classic) to the Dashboards (New) format, with minimal intervention from post-migration activity.

Advantages

Dashboards (New):

• Are continuously released and updated with new feature additions.
• Provide the unique ability to analyze metrics metadata and logs data on the same dashboard, in an integrated seamless view. This is exactly what you need to monitor and manage a Kubernetes environment effectively.
• Give you control over the visual display of metric and logs data.
• Streamline dashboard configuration and on-the-fly analytic visualizations with its new templating features.

Changes after migration

This table shows the complete list of features that are changed after the implementation of the Migrate to New Dashboards feature.

Features	Supported	Not Supported
Theme	No effect, migrated as it is	NA
Dashboard Layout	Panel position in the grid stay the same Panel heights might slightly differ	NA
Chart colors	Exact color won’t be preserved, although color families will be preserved.	NA
Table Panels	Font size conversion: Small >8 Normal >12 Large >16	Text Truncation
Bar/Column panel	Stacking settings: None - default Normal - stacked Percent - stacked percent Legend Position Axis settings Multi-series support (Enabled in new dashboards as overrides)	Color by range Label truncation
Line/Area panel	Stacking settings: None - default Normal - stacked Percent - stacked percent Line settings Marker type Line Thickness Marker size Smooth lines Legend Position Axis settings Multi-series support (Enabled in new dashboards as overrides)	Color by range Label truncation Grideline settings
Pie/Donut panel	Number of slices Legend position Converted to pie panel by default	Donut panels are not supported on new dashboards Border settings
SVP panel	Show/hide number Unit (called “label” in new dashboard) No data behavior Color by range (called “thresholds” in new dashboard	Label title Background color
Map panel	Migrated as is	NA
Text/Title panel	Migrated as is	NA
Box plot / Sankey	Added functionalities to support the chart types, refer to Limitation	❌
Panel time ranges	Migrated as is	NA
Dashboard time range	Migrated as is	NA
Metrics query data interpolation	NA	❌
Metrics series	Visibility on legend Axis settings
Metrics panel (Line)	Line width Axis settings	Chart stepping
Metrics panel (Area)	Line width Chart stacking Axis settings
Metrics panel (Single Value)	Statistic Type Label Show/hide value No data behavior Thresholds Show color as: Text	Rounding Show color as: Background
Metrics panel (Single Value (Gauge)	Statistic Type Label Show/hide value No data behavior Thresholds Gauge range settings
Metrics panel (Single Value (Sparkline)	Statistic Type Label Show/hide value No data behavior Thresholds Show color as: Text	Rounding Show color as: Background

Migration Steps

caution

We do not guarantee 100% conversion from classic to new dashboard, although we do provide an exhaustive list of incompatibilities that need to be taken care of. You can still keep your old dashboard after migration.

This section explains to you the step-by-step process to migrate your dashboards.

1. Navigate to any of your classic dashboards or create a new one. Click Migrate to new dashboards link.
   
2. A dialog box appears. Click Migrate to New Dashboard as shown below.
   
3. Click Open Dashboard to view the migrated dashboard, given the migration is successful.
   
   The following dialog can have 2 other states:
   1. Warning State. Showing any warnings during migrations: warnings don’t fail the migration process, however, it might be something that you have to fix on your own or is a feature that is not yet supported on the new dashboard.
      
   2. Error State. The process can sometimes run into an error state, this fails the migration and the new dashboard is not created.
      

Bulk Migration

The bulk migration feature is an extension to the dashboard migration feature that allows the user to migrate multiple classic dashboards at once:

1. Go to Library, and select two or more Dashboards. Click Migrate Dashboards link.
   
2. A dialog box appears. Click Migrate to New Dashboard as shown.
   
3. The bottom right corner shows real-time information on the migration process.
   
4. The following information is populated once the migration is complete.
   • Summary of the process.
   • Hovering on the error (if any) shows the error information in the tooltip.
   • The dashboard's blue names are clickable and open up the dashboard.
     

info

Choosing more than fifty dashboards will disable the Migrate button.

Limitations

Incompatibility	Description
Panels	Box plot and sankey diagrams are not supported Incompatible panels are automatically migrated to text panels with all the information about the panel preserved in the panel Retained information in text panel: Query Time range Panel title
Public dashboards	Public dashboards are not yet supported by New Dashboards