Configure and use a heatmap visualization in Dynatrace
To visualize your query results as a heatmap, select
Heatmap
from the list above the query definition, in the upper-left corner of the page.
Example in the Data explorer
Change visualization
When switching between visualizations, be aware that some visualization settings are visualization-specific.
-
If you select a visualization and configure Settings for that visualization, and then you switch to a different visualization, some of your settings for the first visualization may be ignored because they don't apply to the newly selected visualization. An information icon in the list of visualizations will alert you to the possibility.
-
If you switch back to the original visualization, you may need to reconfigure some visualization settings.
Change metric selection
By default, this visualization shows the first metric of a multi-metric query.
To select a different metric from a multi-metric query, you can select the letter next to the metric you want to visualize, or you can select the eye icon .
Settings
The Settings section is one of the expandable sections in the right panel of the Data explorer page. The contents of the Settings section may vary depending on the visualization you have selected.
Resolution
Resolution is the X axis (time) granularity of the visualization.
- To allow the Data explorer to automatically select an appropriate resolution for the selected timeframe, in the Settings section, set Resolution to
Auto
- To specify a certain resolution, select one from the list
Some resolutions are unavailable for some timeframes. If you select an incompatible combination of timeframe and resolution, Dynatrace automatically selects a resolution and displays an explanatory message such as: Auto-resolution applied. Resolution value of [6 hours] applied. Selected timeframe doesn't allow for [5 minutes] resolution.
To override auto-resolution, select a different resolution from the list.
To prevent performance issues on dashboard tiles created with the Data explorer, the maximum number of data points for a query on a dashboard tile is 4,000. Based on the selected timeframe and the applied custom resolution, Dynatrace projects the number of data points for the query result. If the projected number of data points exceeds 4,000, Dynatrace automatically switches to a resolution high enough to keep the number of data points below 4,000.
Note that this does not apply to visualizations in the Data explorer itself, where you can have more than 4,000 data points. It applies only to dashboard tiles created with the Data explorer where the resolution/timeframe combination selected on the dashboard results in more than 4,000 data points.
Show legend
Whether to show a legend that matches the colors to the value range.
Show labels
Whether to show a value (count) for each bucket.
Y axis
Whether to show the Y axis by value or split by dimensions.
Buckets
The number of buckets to display on each axis.
- The default value for each axis is
Auto
. - To manually specify a bucket number, enter the number. You can return it to
Auto
by clearing the value.
Settings per metric
The Settings section also displays visualization options per metric selected for the query.
Rename a metric
You can change the name of a metric as it is displayed on the chart and in the chart legend. The query definition retains the metric's original name.
- In the Settings section, select
for the metric you want to rename.
- Edit the name, and then select the checkmark to save the new name.
Change color palette
To change the color palette for a metric, in the Settings section, select a new palette from the list.
Unit and Format
Use the Unit and Format settings to determine how your data is displayed. If you export to a CSV file, the Unit and Format settings are also reflected in the exported values.
Unit
Use the Unit setting to set the unit in which the metric is displayed.
None
= No unit displayedAuto
= Dynatrace selects an appropriate display unit- Other selections specify the exact unit to display. The options here depend on the metric's unit. A time metric, for example, offers alternative units for displaying time.
- To add a custom unit/suffix string, type the custom string in the Unit box and then select it from the list.
- In Advanced mode, you can use
:setUnit(<unit>)
to select from a wider range of units.
Examples of order-of-magnitude notation in Dynatrace:
Notation | Factor | Meaning |
---|---|---|
k | 10^3 | kilo, thousand |
M | 10^6 | mega, million |
G | 10^9 | giga, billion |
T | 10^12 | tera, trillion |
Format
Use the Format setting to configure the number of decimal places displayed for the selected metric.
None
= No formatting.Auto
= Dynatrace selects an appropriate format. For example, whereNone
would display5.062357754177517 %
,Auto
would display5.06 %
.- Other selections specify the number of decimal places to display:
0
,0.0
,0.00
,0.000
Examples
Threshold
The Threshold section is one of the expandable sections in the right panel of the Data explorer page. The contents of this section may vary depending on the visualization you have selected. Use threshold settings to enhance your visualizations and tiles.
Tip: Set threshold values after you set Unit:
- If you set Unit first, the threshold settings are prepared to match the selected unit.
- If you change Unit after you set threshold values, the threshold values are not automatically adjusted to match the new unit setting.
Set thresholds
Hide or show threshold colors
To hide or show threshold colors without deleting the threshold settings, in the Thresholds section, select .