Edit dashboard JSON

You can edit the JSON definition of your dashboard offline or, for small changes, edit the JSON directly in Dynatrace.

API alternative

To manage dashboard JSON at scale, you need the Dashboards API.

Edit offline

Use this procedure to download a dashboard's JSON definition, edit it offline, and upload it back to Dynatrace.

When you upload a dashboard using this procedure, you overwrite the dashboard whose definition you originally downloaded. If you want to upload a dashboard definition to a new dashboard, see Import dashboard below.

  1. Display the dashboard.
  2. Select Edit.
  3. Switch to the Settings tab.
  4. Select the Advanced settings link.
  5. Select Dashboard JSON.
  6. On the Dashboard JSON page, select Download.
    A JSON file with the dashboard's name is downloaded to your local machine.
  7. Edit the JSON in your preferred development environment.
    For JSON syntax details, see the Dashboards API Documentation.
  8. On the Dashboard JSON page, select Upload, browse for the edited JSON file, and upload it to Dynatrace.
    The uploaded JSON is displayed on the Dashboard JSON page.
  9. Select Save changes to replace the old JSON with your edited JSON.
  10. Display the dashboard to verify your changes.

Edit in Dynatrace

  1. Display the dashboard.
  2. Select Edit.
  3. Switch to the Settings tab.
  4. Select the Advanced settings link.
  5. Select Dashboard JSON.
  6. On the Dashboard JSON page, the dashboard JSON is displayed in an edit window.
  7. Click in the displayed JSON and start editing.
    • You can work directly in the edit window or copy and paste back and forth from another editor.
    • The You have unsaved changes message in the lower left of the page will remind you that you have work in progress. Be sure to save before you navigate away from the page.
    • Syntax is checked each time you save. You can work incrementally and use Save changes to verify that it still parses.
    • For JSON syntax details, see the Dashboards API Documentation.
  8. When you are finished, display the dashboard to verify your changes.

Import dashboard

Use this procedure to import a dashboard definition as a new dashboard.

When you import a dashboard using this procedure, you add a new dashboard to Dynatrace. If you want to overwrite an existing dashboard, see Edit offline above.

Download the dashboard

If you want to start from an existing dashboard definition

  1. Display the dashboard in Dynatrace.
  2. Select Edit.
  3. Switch to the Settings tab.
  4. Select the Advanced settings link.
  5. Select Dashboard JSON.
  6. On the Dashboard JSON page, select Download.
    A JSON file with the dashboard's name is downloaded to your local machine.

Edit the dashboard

Edit the dashboard JSON in your preferred development environment. For JSON syntax details, see the Dashboards API Documentation.

Import the dashboard

  1. In the Dynatrace menu, go to Dashboards.
  2. Select Import dashboard.
  3. Find and select the file containing the JSON definition of the dashboard you want to import.
    The imported dashboard opens in edit mode.