Edit dashboards

Latest Dynatrace

Use these procedures to edit your dashboard.

Add

Create a dashboard

To create a new dashboard

  1. Go to Dashboards.
  2. In the Dashboards panel, select New dashboard.

Query Grail

The fastest and easiest way to explore your data is with our new Explore tiles and sections. In a few seconds, you can find and analyze your logs, metrics, or business events. No DQL required!

To Query Grail

  1. In the upper-right of the dashboard, select Add > DQL.

    Add tile button

    A configuration side panel opens on the right to display two tabs:

    • Data
    • Visual

  2. On the Data tab, use the Dynatrace Query Language (DQL) to define your query.

  3. Select Run to execute the query.

  4. On the Visual tab, choose a visualization format for your results.

    • means the visualization type is unavailable for your query.

  5. Under the Visualization selector, expand the options sections to adjust visualization settings as needed.

  6. Close the side panel when you're done.

    If you want to return to these settings, select your tile to display them.

For details, see Add data to a dashboard.

Add code

To add code to a dashboard

  1. In the upper-right of the dashboard, select Add > Code.

    Add tile button

    An empty tile is added to the dashboard and an Options side panel opens on the right.

  2. optional In Tile title, enter a title to display at the top of your tile.

  3. In the numbered Code box, enter custom JavaScript to fetch external data from any available API. Use the Fetch API to fetch data from external APIs.

    To make sure your requests aren't blocked, ask your administrator to allow your external data sources by adding them to the Limit outbound connections settings.

    1. Go to Settings and open Preferences > Limit outbound connections.

    2. Select Add item and add the address of the web service you'd like to connect to.

      Don't include the address prefix. For example, if the address is https://some.service.org, just add some.service.org.

    3. Select Save changes.

    This way you can granularly control the web services your dashboard can connect to.

For details, see Add code to a dashboard.

Add markdown

To add a markdown tile to a dashboard

  1. In the upper-right of the dashboard, open the Add menu and select Add markdown.

    Add tile button

    An Options side panel opens on the right.

  2. In the Options side panel, enter your text.

    • Use Markdown to format your text and add links and images.
    • The tile is updated as you edit.
    • While you're editing text, press Ctrl+Space to see options.

  3. Close the Options side panel when you're done.

For details, see Add Markdown to dashboard.

Add variable

Use variables to filter your dashboards, to act as variable values in code tiles, and as placeholders in tile titles and Markdown tile text.

To add a variable to a dashboard

  1. In the upper-right corner of the dashboard, select > Variables.

    Add tile button

    The Variable panel is displayed.

  2. Define the variable.

    • Name: the name of the variable.
      • Only alpha-numerical values are allowed
      • A variable name must not start with dt_
    • Type: can be one of the following:
      • Query: the value is returned from a query you enter when you define the variable.
        • Select Run query to test your query.
      • Code: the value is returned from code you enter when you define the variable.
      • CSV: a comma-separated values (CSV) list of values.
        • To define possible values, enter them (separated by commas) in the box under Type.
        • To define a default value, select one from the Default value list.
        • To allow multiple values to be selected at the same time, turn on Multi-select.
      • Text: free text. You can enter a Default value. Your changes are saved automatically.

  3. Set Display settings.

    • Turn on the Display as filter on dashboard toggle if the variable dropdown should be displayed on the dashboard. Turn it off when you want it hidden, such as when the variable is used as a static value across tiles but should not be displayed to the dashboard user.
    • Turn on the Multi-select toggle if users should be able to select multiple values at the same time within the variable dropdown. Turn it off when you want to use only single values of the variable dropdown.
    • Select a Default value for the variable dropdown. If you do not enter anything in this field, the first available value will be selected.

  4. When you're finished, select < Variable at the top to go to the Variables panel, or close the panel to display the dashboard.

Variables in dashboards can be defined to depend on other variables.

  • The value of a variable is recalculated if its definition refers to another variable and the other variable's value changes.

    For example, if the value of variable A changes, the value of any variable whose definition refers to variable A is recalculated.

  • Loops are not allowed.

    For example, if the value of variable A depends on the value of variable B, the value of variable B can't depend on the value of variable A.

For details, see Add a variable to a dashboard.

Add snippet

To get started based on a snippet

  1. In the upper-right of the dashboard, select Add and choose a snippet from the Start with a snippet section.

    Add tile button

    The edit panel displays the snippet.

  2. Edit the query or code (depending on the snippet type you selected) and the visualization settings as needed.

  3. Select Run query.

  4. In the Result section, select Select visualization to choose a visualization format for your results.

  5. Select < Options to return to the Options panel.

  6. In the Result section, select Customize… to adjust visualization settings as needed.

  7. Select < Options to return to the Options panel.

  8. Review the results.

  9. Close the side panel when you're done.

For details, see Add a snippet to a dashboard.

Layout

Move a tile

You can move one tile at a time or select and move multiple tiles simultaneously.

To move one tile at a time

  1. Hover over the tile to display the tile-specific commands.
  2. Select and drag Move to drag the selected tile to a new location.

To move multiple tiles simultaneously

  1. Click one tile to select it.
  2. Ctrl-click additional tiles that you want to move.
    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.
  3. Select and drag Move to drag all of the selected tiles to a new location.

Resize a tile

To resize a tile

  1. Hover over the tile to display the tile-specific commands.
  2. Select and drag Resize in the lower-right corner of the tile to change the size and shape of the tile.

Copy and paste a tile

You can copy and paste tiles to the same dashboard or another dashboard.

To copy and paste one tile

  1. Select the tile to display the tile-specific commands.

  2. On the tile command bar, select Copy to clipboard.

    The selected tile is copied to your clipboard.

  3. Paste the tile (Ctrl-V).

    • You can paste the copied tile to the current dashboard, in which case it's the equivalent of Duplicate.
    • You can switch to another dashboard and paste the copied tile there.

To copy and paste multiple tiles simultaneously

  1. Click one tile to select it.

  2. Ctrl-click additional tiles that you want to copy and paste.

    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.

  3. On the tile command bar, select Copy to clipboard.

    The selected tiles are copied to your clipboard.

  4. Paste the tiles (Ctrl-V) to the same dashboard or switch to another dashboard and paste them there.

Open a tile with another app

To open one or more tiles with a different application

  1. Hover over the tile to display the tile-specific commands and then select More actions > Open with.

    You can select and open multiple tiles in another application simultaneously.

    1. Select one of the tiles that you want to open in another application.
    2. Ctrl-Click the remaining tiles that you want to open in another application. All selected tiles will be highlighted.
    3. Select Open with….

  2. In the Open with… window, select the other application in which you want to open the tile.

Example

In this example, we have a useful section of a notebook that we want to copy over to a dashboard.

To copy a notebook section to a dashboard (as a dashboard tile)

  1. In the notebook, select the notebook section that you want to copy to a dashboard.

  2. Select > Open with.

  3. In the Open with… window, select the Dashboards option.

    A Select destination box is displayed.

  4. In Select destination, you can create a new dashboard or select an existing dashboard.

  5. Select Add.

    The dashboard opens with the selected section copied into it.

For details, see Open with.

Duplicate a tile

You can duplicate one tile at a time or duplicate multiple tiles simultaneously.

To duplicate one tile

  1. Select the tile to display the tile-specific commands.

  2. Select Duplicate.

    A copy of the tile is created on the current dashboard.

To duplicate multiple tiles simultaneously

  1. Click one tile to select it.

  2. Ctrl-click additional tiles that you want to duplicate.

    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.

  3. On the tile command bar, select Duplicate.

    The selected tiles are duplicated on the current dashboard.

Delete a tile

You can delete one tile at a time or select and delete multiple tiles simultaneously.

To delete one tile

  1. Select the tile to display the tile-specific commands.
  2. On the tile command bar, select More actions > Delete.
  3. In the Are you sure you want to delete this tile? message, select Cancel or Delete.

To delete multiple tiles simultaneously

  1. Click one tile to select it.
  2. Ctrl-click additional tiles that you want to delete.
    • Each selected tile is highlighted.
    • The total number of selected tiles is displayed on the tile command bar.
  3. On the tile command bar, select Delete.
  4. In the Are you sure you want to delete this tile? message, select Cancel or Delete.

Edit a tile

To edit a tile

  1. Select the tile to display the tile-specific commands.

  2. Select Edit.

    An Options panel opens on the right to display the tile or section configuration.

  3. Select and drag the expander control left or right as needed to resize the Options panel for a better look at the code.

    Resize options panel

Download result

To download (export) the result of the current dashboard tile or notebook section

  1. Hover over the tile or section to display available commands.

  2. On the command bar, select More actions > Download result > [format].

    The result is downloaded to a local file in the selected format.

    The selection of download formats available depends on the visualization.

    • CSV: The result is downloaded to a local comma-separated values (*.csv) file
    • JSON: The result is downloaded to a local JSON (*.json) file

    Some visualizations offer no option for downloading the result.

Troubleshooting

Dynatrace version 1.277+ Dashboards app version 1.10.0+

  • In Dynatrace version 1.276 and earlier, in the Dashboards app, values from query, code, and CSV variables were automatically converted to numbers where possible.

  • In Dynatrace version 1.277+ (Dashboards app version 1.10.0+), all such variable values are returned as strings.

Issue: Starting with Dynatrace version 1.277, errors might occur in some previously existing Dashboards app dashboards that depend on the previous conversion (for example, your query expects a number, but it now receives a string).

Solution: Use DQL conversion functions in your queries to convert values as needed.