Latest Dynatrace
These procedures describe the basics of using dashboards and get you started on the way to customizing and creating your own dashboards.
To list dashboards
Go to Dashboards.
In the Dashboards panel, the Recently modified section lists recently modified dashboards.
Hover over a dashboard name and select for a menu of available commands for that dashboard. In this example, we would display the menu for a dashboard called my dashboard 3
.
The commands you see in the menu depend on your permissions for that dashboard. For example, you can't rename someone else's dashboard unless they have given you edit permissions for that dashboard. (But you can make a copy of a shared dashboard and then edit your copy.)
This icon after a dashboard name means someone shared that dashboard with you.
To display a table of all dashboards to which you have access—your own dashboards and all dashboards that people have shared with you—select All dashboards.
To close the Dashboards table and return to your initial view, select Dashboards in the upper-left corner of the Dashboards page.
To list all dashboards you own
To list all dashboards shared with you
To list all ready-made dashboards
Alternatively, you can select All dashboards and then change the filter at the top of the table from All dashboards to Ready-made.
To display a dashboard
Go to Dashboards.
In the Dashboards panel, select the name of the dashboard. In this example, we open my dashboard 2
.
The timeframe describes the when of the data on the dashboard.
When you open a dashboard for the first time, the standard global timeframe (Last 2 hours) is applied.
If you change the global timeframe setting for your dashboard, that timeframe is applied the next time you open the dashboard. However, there are exceptions as described below.
You can set a dashboard-specific default timeframe that is applied each subsequent time you open the dashboard.
You can set a tile-specific timeframe. This setting overrides the global timeframe.
When you open a dashboard via a link, if a timeframe is included in the link, the link timeframe is applied and the default dashboard timeframe is ignored.
To change the global timeframe
When you change the global timeframe:
To set a default timeframe for a specific dashboard
When you set a default dashboard timeframe, that timeframe is applied when you open the dashboard.
To specify a custom timeframe in a dashboard tile
Edit the tile.
In the edit panel, turn on Custom timeframe.
Select the timeframe to apply to the selected tile.
This timeframe overrides the dashboard timeframe set in the upper-right corner of the dashboard. Using this method, a dashboard can have multiple tiles, where each tile has its own timeframe.
You can also specify a custom timeframe in a data tile's DQL query. If you use this method (with a timeframe specified in the query), the above UI setting is disabled and the timeframe specified in the query is used.
Example timeframe specification in DQL:
fetch [recordtype], from:now() - 2h| ....
For details on specifying a timeframe in DQL, see Specify timeframe in the DQL documentation.
To filter data, you can specify segments at two levels: dashboard and tile. Tile-level segment selections override dashboard-level segment selections.
Use segments when you want to reuse them across dashboards. For example, use segments for recurring filters such as for your Kubernetes clusters, namespaces, workloads, or pods. Segments automatically apply on top of the queries of your tiles/sections, so you don’t need to reference them within.
If you need more control over how a filter is applied, however, you might want to use variables.
equals
, contains
, startsWith
, and endsWith
).For a Dashboards-specific segments use case, see Analyze monitoring data with Dynatrace segments.
To select dashboard-level segments
Display the dashboard.
Open the segment selector at the top of the dashboard and, in Filter by segments, select a segment.
If the segment requires an additional value selection, select it now.
To add another segment, select Segment. Repeat this step for each segment you want to add.
Select Apply to apply the selection and filter data on the dashboard.
To select tile-level segments
Display the dashboard.
Select the tile and then select in the tile controls to edit the tile.
In the edit panel, turn on Custom segments.
In the Custom segments list, select a segment.
If the segment requires an additional value selection, select it now.
To add another segment, select Segment. Repeat this step for each segment you want to add for the selected tile.
Select Apply to apply the selection and filter data on the tile.
If you see something on a dashboard that you want to zoom in on, you can maximize it and have a closer look, and then minimize it again when you're done.
When you maximize a tile, it is temporarily zoomed to the maximum size of the display so you can see the details of the selected tile.
To maximize a tile
To return to the normal dashboard view, select Minimize in the upper-right corner.
When you open a document from another user, you may see the following message:
This dashboard contains custom code. It is read-only until you review the code and select “Accept and run”.
When you run a code tile or section written by another person, Dynatrace executes the other person's JavaScript using your user account and your permissions. This is a powerful feature, but it needs to be used correctly and responsibly. The JavaScript code can access external APIs on your behalf (using your account and permissions).
To review code
Select Review all code.
The Review code page displays each code tile's code in a separate box.
Review the code and decide whether you want to run it.
If you want to run the code, you can approve it just this time or permanently.
If a dashboard has one or more variables, they are listed by name along the upper-left of the dashboard, under the dashboard name. When you change variable values, the dashboard contents are recalculated and displayed according to the new values.
To change the value of a variable
In the upper-left of the dashboard, locate the variable name in the upper-left of the dashboards.
Use the menu or edit box under the variable name to change the value.
When you open a dashboard for the first time, the refresh rate is set to Off
(no automatic refresh).
To refresh the current dashboard manually, in the upper-right corner of the dashboard, select (in the pair).
To refresh the current dashboard automatically, in the upper-right corner of the dashboard, select (in the pair) and select a refresh rate.
Off
turns off automatic refreshIf you change the refresh rate, that rate is remembered the next time you open the dashboard.
A frequent refresh rate can keep you literally up to the minute, but a complex dashboard may take some time to recalculate each time it is refreshed. Choose a refresh rate that suits your needs and the complexity of the dashboard.
Dashboard versions are saved automatically.
To view and manage dashboard versions
Display your dashboard.
In the upper-right corner of your dashboard, select .
This displays a menu of the most recent versions of the current dashboard.
From any version entry in the Versions menu, you can select version-specific actions.
To list and manage all versions of the dashboard in a separate window, go to the bottom of the Versions menu and select Show all.
For details, see Manage document versions.
To download (export) the result of the current dashboard tile or notebook section
Hover over the tile or section to display available commands.
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.
Some visualizations offer no option for downloading the result.
To add your dashboard to the Dock for easy access, open the menu next to the dashboard name and select Add to Dock.
If you own a document (dashboard or notebook), you can share it.
There are two ways to share a document with other Dynatrace users in your company:
These methods are not mutually exclusive. For example, you can maintain a focused list of users for ongoing access to the document (maybe everyone in a certain group edits the document regularly) and you can create and distribute view-only links for a wider audience as needed.
In either case, you control whether people can edit the document or only view it.
For details on sharing documents, see Share documents.
When you create a document (dashboard or notebook), you are the owner. To give ownership of the document to another Dynatrace user
Open the document menu and select Change owner.
Find and select a new owner, and then select Change owner.
When you change the document owner, you immediately lose access to the document.
After the transfer is complete, the new owner will receive email about the document ownership transfer.
To make a copy of the current dashboard
At the top of the dashboard, open the dashboard menu next to the dashboard name.
Select Duplicate from the menu.
A copy is created with the name Copy of + the name of the current dashboard. The copy is now listed in the Dashboards panel.
To download (export) the current dashboard as JSON
At the top of the dashboard, open the menu next to the dashboard name.
Select Download from the menu.
The definition of the current dashboard is downloaded to a local JSON file.
To download (export) a dashboard from the side panel
Go to Dashboards.
In the Dashboards app, the side panel lists your Recently modified dashboards.
Hover over the name of the dashboard you want to export and select > Download. The dashboard is downloaded to a local JSON file that you can upload.
To upload (import) the JSON definition of a dashboard from the Dashboards side panel
To upload (import) the JSON definition of a dashboard from the Dashboards table
Go to Dashboards.
In the Dashboards panel on the left, select All dashboards.
A Dashboards table displays all dashboards by Name and Last modified date.
In the upper-left corner of the page, select Upload.
Find and open the dashboard JSON definition file.
An uploaded dashboard is:
Opened in Dynatrace.
If you see a message about running custom code when you upload a dashboard, see Run code warnings for more information.
Added to your Recently modified list.
Added to the Dashboards page with Last modified set to the upload date and time.
Use Open with to copy a dashboard tile to another document (such as a different notebook or dashboard).
For example, an easy way to start a new document (dashboard or notebook) is to use Open with to copy reusable sections from existing documents (dashboards or notebooks) to a new document and then edit the copied sections as part of the new document.
To copy a dashboard tile to a notebook (as a notebook section)
In the dashboard, select the tile that you want to copy to a notebook.
Select > Open with.
In the Open with… window, select the Notebooks option.
A Select destination box is displayed.
In Select destination, you can create a new notebook or select an existing notebook.
Select Add.
The Dashboards application opens with the selected section copied into a new or existing dashboard (depending on what you chose in Select destination).
For details, see Open with.