Table visualization
Latest Dynatrace
Use the table visualization:
- When you want to get a first sample and impression of the data returned by your query or code. For example, show me the top recent 100 log lines for my application or host.
- When you want to go through many records at a time. Where data density and being able to compare records one by one is more important than seeing all fields that are contained in the result at the same time.
- When you need to further explore the data via interactions.
Example
The table above is based on the following query.
timeseries cpu=avg(dt.host.cpu.usage), by:{dt.entity.host}| sort arrayAvg(cpu), direction:"descending"| limit 3
- The visualization type is set to Table.
- Sparkline for timeseries is turned on. The
cpu
column is a timeseries, so it's rendered as a sparkline. - In the Column visibility section, the
dt.entity.host
column is hidden and the other three columns (timeframe
,interval
, andcpu
) are shown.
Title
Use this field to add a title. The edit box is displayed at the top of the options panel.
- You can use emojis such as 😃 and 🌍 and ❤️.
- You can use variables.
Example:
- Define variables called
Status
andEmoji
in your dashboard. - Set Title to
Current $Emoji status is $Status
. - Set
Status
toGood
. - Set
Emoji
to🌍
.
The title will be displayed as Current 🌍 status is Good
.
Visualization
If you aren't sure that you chose the right visualization, use the visualization selector to try different visualizations.
Data mapping
The data mapping section shows how a column of your result is mapped to the visualization.
In a table visualization, the Data mapping section lists all table columns.
- Use the checkboxes to select which columns to display.
- Use Show/hide all to toggle the selection of all columns at once. For example, you can hide all columns and then use the individual checkboxes to select some subset of the columns to display.
When you download table data to a file (select > Download result > CSV), the download includes only the columns selected in the Data mapping section.
This is useful when, for example, you want to download a CSV file, open it in a spreadsheet, and share the spreadsheet with others. Use data mapping to exclude irrelevant or sensitive data from your download.
Table options
To learn about options quickly and decide what works best for you, turn options on and off and see the effect immediately on your chart. For example, does it look best with a label or without? Turn that option on and off and see for yourself.
-
Density—determines how compact the table rows are displayed vertically.
- Condensed is the tightest display option, for when you need to maximize the number of rows displayed.
- Default is an average display option, with typical spacing between rows.
- Comfortable specifies maximum spacing between rows.
-
Column settings
- Line wrap specifies whether to wrap lines that extend beyond the column width.
- Sparkline for timeseries specifies whether to show a timeseries column as a series of values or as a sparkline.
-
Apply threshold color to specifies whether to display either the Value or the Background in the threshold color.
Query limits
Use the Query limits section to check and adjust the Grail query limits per notebook section or dashboard tile. These settings determine the maximum limits when fetching data. Exceeding any limit will generate a warning.
Dashboard sections and notebook tiles created in Dynatrace earlier than version 1.296 are not affected. Those existing tiles/sections will return the same results as before.
Read data limit (GB)
The limit in gigabytes for the amount of data that will be scanned during a read.
Record limit
The maximum number of result records that this query will return. Default: 1,000 records. To see more records, you need to increase the value of Record limit.
-
If your query has no
limit
, such asfetch logsthe value of Record limit is applied. By default, you will see up to 1,000 records.
-
If your query also includes a
limit
, such asfetch logs| limit 2000the lower of the two values (either
limit
in your query, or Record limit in the web UI) is applied.In the example above, you would still see only 1,000 records unless you increased the value of Record limit.
Result size limit
The maximum number of result bytes that this query will return. For better performance with typical queries and smaller documents, the default is set to 1 MB.
Sampling (Logs and Spans only)
Results in the selection of a subset of Log or Span records.
Units and formats
To override the default units and formats in a dashboard or notebook visualization
-
Select to edit the visualization tile.
-
Select the Visualize tab.
-
Select Units and formats.
-
Select Override.
-
Select Override
-
In the dropdown list, select the item for which you want to add a unit override.
This is a numeric column of the underlying DQL result, so it varies according to the query. For example:
- A
fetch events
query returns events. The dropdown list here lets you select a numeric field (such astransfer_size
) from the results. - A
timeseries avg(dt.host.cpu.usage)
query returns a single timeseries foravg(dt.host.cpu.usage)
. That timeseries is then the only selectable option in the list.
- A
-
Define the override.
- Default unit: The base unit in which the values were captured. It's
None
if it was not included in the DQL result, or its automatically defined by the unit passed from the DQL result. This field doesn't lead to any conversion. - Displayed unit: Once you define a default unit, you can use Displayed unit for conversion. For example, if the DQL result defined your numeric value in the result as
Bytes
, Displayed unit now offers a suitable list of byte conversions such asKilobyte
andMegabyte
. Unlike the Default unit, the Displayed unit is always a numeric conversion. - Decimals displays the default number of decimals (degree of precision) to display. To see it in action, change the Decimals selection and observe the change in the visualization.
- Suffix displays the suffix to display after the unit. To see it in action, enter a string and observe the change in the visualization. When you don't find the unit you're looking for, you can use Suffix to display the desired unit.
- Default unit: The base unit in which the values were captured. It's
-
Turn on Abbreviate large numbers if you want to display large figures in abbreviated form. For example,
1053
becomes1.1K
.
To reset to defaults (discard override settings for the selected item), select the trash can next to the item.
This example uses a line chart, but the options apply to other visualizations.
-
In Dashboards, create a dashboard.
-
Select and, in the Snippets section of the menu, select Metrics > Chart average CPU across all hosts.
-
In the section edit panel, select the Visualize tab and select Line chart.
-
Select Units and formats.
-
Select Override.
-
In the dropdown list, select the metric for which you want to add an override. There's only one metric to select in this example.
-
Define the override for the displayed metric. You can observe your changes in the Y-axis of the chart.
-
Default unit displays
Percent (%)
, which is the default unit for the selected metric. Try a different setting, such asOne
to instead display the result as a fraction of 1. -
Displayed unit displays
Auto
. You can change it to a different unit, such asOne
to instead display the result as a fraction of 1.Only linear and static conversions are supported. For example, you cannot convert
Degree Celsius(°C)
intoDegree Fahrenheit(°F)
, or convertUsd(US$)
intoEur(€)
. -
Decimals displays the default number of decimal points (degree of precision) to display. To see it in action, change the Decimals selection and observe the change in the visualization.
For example, change this:
To this:
-
Suffix displays the optional suffix to display after the unit. To see it in action, enter a string and observe the change in the visualization.
-
To reset to defaults (discard override settings for the selected metric), select the trash can next to the metric.
Thresholds
Configure thresholds
To configure thresholds in a dashboard or notebook visualization
-
Select to edit the visualization tile.
-
Select Thresholds.
- In Dashboards, select the Visualize tab in the side panel, and then select Thresholds.
- In Notebooks, select Thresholds in the side panel.
-
Select Add threshold.
-
Define the thresholds. For each range:
- Select a color to display for that range
- Select the operator to define the threshold for that range
- Enter a static value to compare (using the selected operator) with the returned value
- Enter a label to associate with the defined range.
- Labels apply only to charts with a Y axis, such as timeseries charts and the categorical bar chart.
- Labels can't be defined for tables and the single value chart.
This example uses a bar chart, but the options apply to other visualizations.
-
In Dashboards, create a dashboard.
-
Select and, in the Snippets section of the menu, select Metrics > Chart top 10 hosts by CPU usage.
-
In the section edit panel, select the Visualize tab and select Bar chart. (To simplify the examples, we hid the chart legend (see Legend in Bar chart options), but that makes no difference to thresholds.)
-
Select Thresholds.
-
Select Add threshold.
An empty set of threshold fields is displayed.
-
Define the thresholds for the displayed metric. You can observe your changes in the Y axis of the chart.
In this example, we define three ranges of CPU usage with corresponding colors and labels.
You can see the ranges displayed on the Y-axis and in the tooltip.
To reset to defaults (discard threshold settings), select the trash can next to the item.
Edit thresholds
-
Select to edit the visualization tile.
-
Select Thresholds.
- In Dashboards, select the Visualize tab in the side panel, and then select Thresholds.
- In Notebooks, select Thresholds in the side panel.
-
From this point, you can do the following (expand rows for details):
To add thresholds (if the selected visualization supports additional thresholds), select Add threshold.
To turn off (hide) existing thresholds, use the switch. No settings are lost. You can turn them back on if you change your mind.
To delete existing thresholds, select the trash can .
To change existing threshold settings, just edit the fields.
To add a range to existing thresholds, select Add range.
To delete a range from existing thresholds, select the delete button in that row.