Edit dashboards

Latest Dynatrace

Use these procedures to edit your dashboard.

Add

Create a dashboard

To create a new dashboard

In the Dynatrace Launcher, select Dashboards.

The Dashboards app starts.
In the Dashboards panel, select New dashboard.

Query Grail

The fastest and easiest way to query your logs is to use the new query builder. In a few seconds, you'll have a working log query you can add to your document and tweak as needed.

To Query Grail

In the upper-right of the dashboard, open the Add menu and select Query Grail.

An Options side panel opens on the right.
In the edit box, use the Dynatrace Query Language (DQL) to define your query.
Select Run query to execute the DQL query and display visualization options.
In the Result section, select Select visualization to choose a visualization format for your results.

If a visualization is already selected, you can select Change visualization to select a different visualization.
Select < Options to return to the Options panel.
In the Result section, select Customize… to adjust visualization settings as needed.
Select < Options to return to the Options panel.
Close the side panel when you're done.

For details, see Add data to a dashboard.

Add code

To add code to a dashboard

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

An empty tile is added to the dashboard and an Options side panel opens on the right.
optional In Tile title, enter a title to display at the top of your tile.
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.
In the Dynatrace menu, go to Settings and open Preferences > Limit outbound connections.

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.

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

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

An Options side panel opens on the right.
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.
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

In the upper-right of the dashboard, open the Add menu and select Add variable.
Define the variable.
Select Add variable to save your changes.

For details, see Add a variable to a dashboard.

Add snippet

To get started based on a snippet

In the upper-right of the dashboard, open the Add menu and select Add snippet > [snippet category] > [snippet name].

The edit panel displays the snippet.
Edit the query or code (depending on the snippet type you selected) and the visualization settings as needed.
Select Run query.
In the Result section, select Select visualization to choose a visualization format for your results.
Select < Options to return to the Options panel.
In the Result section, select Customize… to adjust visualization settings as needed.
Select < Options to return to the Options panel.
Review the results.
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

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

To move multiple tiles simultaneously

Click one tile to select it.
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.
Select and drag Move to drag all of the selected tiles to a new location.

Resize a tile

To resize a tile

Hover over the tile to display the tile-specific commands.
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

Hover over the tile to display the tile-specific commands.
On the tile command bar, select Copy to clipboard.

The selected tile is copied to your clipboard.
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

Click one tile to select it.
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.
On the tile command bar, select Copy to clipboard.

The selected tiles are copied to your clipboard.
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

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.
Select one of the tiles that you want to open in another application.
Ctrl-Click the remaining tiles that you want to open in another application. All selected tiles will be highlighted.
Select Open with….
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)

In the notebook, select the notebook section that you want to copy to a dashboard.
Select > Open with.
In the Open with… window, select the Dashboards option.

A Select destination box is displayed.
In Select destination, you can create a new dashboard or select an existing dashboard.
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

Hover over the tile to display the tile-specific commands.
Select Duplicate.

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

To duplicate multiple tiles simultaneously

Click one tile to select it.
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.
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

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

To delete multiple tiles simultaneously

Click one tile to select it.
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.
On the tile command bar, select Delete.
In the Are you sure you want to delete this tile? message, select Cancel or Delete.

Edit a tile

To edit a tile

Hover over the tile to display the tile-specific commands.
Select Edit.

An Options panel opens on the right to display the tile or section configuration.
Select and drag the expander control left or right as needed to resize the Options panel for a better look at the code.

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.