Exporting and importing dashboards

As a tenant administrator or an editor, export and import one or more dashboards in bulk from one tenant to another tenant. If a dashboard with a same name and UID exists in the new tenant, the import operation will overwrite that dashboard.

Important

  • By default, a maximum of 10 dashboards can be exported or imported at a time.
  • You can export or import only the dashboard definitions, such as variables and panel information. You cannot export or import the dashboard permissions, schedules, and so on.
Example: Export and import dashboards

Let's say you are a tenant administrator in your organization. The tenant server in production will soon be replaced with a new server and you must move a set of dashboards from the old tenant to another. You can export the dashboards in JSON format from the old tenant and import them into the new tenant. You can also select each dashboard folder and data source while importing them.

Related topic

Sharing-and-embedding-dashboards


To export dashboards 

Export dashboards to be used within the same tenant or different tenants. Within the same tenant, you can export multiple dashboards at a time. To import and use dashboards in other tenants, export them one at a time.

To export dashboards within the same tenant

  1. From the navigation navigation_menu.pngmenu, click Dashboards.
  2. Expand the folders that contain the dashboards to be exported.
  3. Select the check boxes corresponding to the dashboards that you want to export.
  4. Click Export.
    The JSON files of the dashboards are downloaded to your computer as compressed files, and the export status is displayed. 

To export dashboards to be used in other tenants

  1. From the navigation navigation_menu.pngmenu, click Dashboards.
  2. Search for the dashboard that you want to export, and click the dashboard name.
  3. Select Share > Export.

    dashboard_export_options.png

  4. Enable Export for sharing externally.
  5. (Optional) To validate the JSON output of the dashboard, click View JSON.
  6. Click Save to file.
    The JSON file of the dashboard is downloaded to your computer as a compressed file, and a confirmation message is displayed.
  7. Repeat these steps to export other dashboards.


To import dashboards

  1. From the navigation menu_icon.pngmenu, click Dashboards.
  2. Click New > Import.
  3. On the Import page, do one of the following actions:

    • Click Upload .json file and browse to the dashboard JSON files that you exported.
      While importing, you can select one or more JSON files.

      Important

      You must import the JSON files individually. You cannot import the zip file that is generated while the dashboards are being exported.

    • In the Import via dashboard json section, paste the dashboard JSON text.
  4. Click Load.
  5. Add a name and select a folder and a data source for the dashboard.

  6. From the view list, select the view name.
    A separate list is displayed corresponding to each panel that uses queries or variables configured by using Visual Query Builder.

    Important

    The view list is displayed only when the following requirements are met:

    • The dashboard to be imported is created in the 24.3 or later version.
    • The dashboard panels are configured by using Visual Query Builder.

    If you import any dashboard created in a version earlier than 24.3, the view list is not displayed. After you import this dashboard, you must reconfigure all the panels that use Visual Query Builder.

  7. If you are importing a single JSON file, click Import or if you are importing multiple JSON files, click Import all.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*