Single value visualization

Latest Dynatrace

When to use a single value visualization

Use a single value visualization when you want to:

Show a single aggregated measurement and its trend over time.
Express important business-related Key Performance Indicators (KPIs).
Express infrastructure-related critical Service Level Objectives (SLOs).

Examples

Example 1

Single value example

The visualization above is based on the following query.

timeseries sparkline=avg(dt.host.cpu.usage)
| fieldsAdd value=arrayAvg(sparkline)

In this example, the chart option selections included:

Record field: value
Alignment: Center
Show trend: On
Trend value: Relative
Show sparkline: On
Sparkline: sparkline

Example 2

Single value chart example

/*
 * This example shows how to map data to use the built-in visualization for custom data.
 */

export default async function () {
  return {
    records: [
      {
        value: 'CPU usage',
        interval: '60000000000',
        timeframe: {
          start: '2023-11-13T07:24:00.000Z',
          end: '2023-11-13T09:25:00.000Z',
        },
        series: [1832, 997, 432, 997, 2343, 997, 544, 997, 234],
      },
    ],
    types: [
      {
        mappings: {
          value: {
            type: 'string',
          },
          interval: {
            type: 'duration',
          },
          timeframe: {
            type: 'timeframe',
          },
          series: {
            type: 'array',
            types: [
              {
                mappings: {
                  element: {
                    type: 'double',
                  },
                },
                indexRange: [0, 120],
              },
            ],
          },
        },
        indexRange: [0, 0],
      },
    ],
  };
}

In this example, the chart option selections included:

Record field: value
Alignment: Center
Icon: Codeicon
Show trend: On
Trend value: Relative
Show sparkline: On

Title

Use this field to add a title. The edit box is displayed at the top of the options panel.

Title edit box

You can use emojis such as 😃 and 🌍 and ❤️.
You can use variables.

Example:

Define variables called Status and Emoji in your dashboard.
Set Title to Current $Emoji status is $Status.
Set Status to Good.
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.

Value—the column of your result that is displayed in the single value visualization.
Sparkline—the value to be reflected in a sparkline in the single value visualization. This also affects the trend, which is calculated as the difference between the first and last elements of the timeseries selected as a sparkline.

Single value 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.

General

Use these options to specify the general display options of your visualization.

Show label specifies whether to show the label on the visualization.
- Label is the text of the label you want to show, such as World 🌍 trend. This configuration option is displayed only if Show label is turned on.
  
  To set a label via DQL using an alias, turn on Show label but don't set Label.
Format specifies whether to format values on the visualization.
Record field specifies the field to display on the visualization.
Alignment specifies left, center, or right alignment for displayed visualization elements.
Icon specifies the icon to display before the value.

Trend and Sparkline

Use these options to specify the trend and sparkline options of your visualization.

Show trend turns the trend icon and value on or off.

The following configuration option is displayed only if Show trend is turned on:
- Trend value specifies whether to show an absolute or percentage trend value.
Show sparkline turns the sparkline on or off.

The following configuration options are displayed only if Show sparkline is turned on:
- Sparkline color specifies the color of the sparkline.
- Sparkline variant specifies whether to display the sparkline as a line or an area.
- Record field specifies the record field to display as a sparkline on the visualization.
- Show ticks specifies whether to display values along the X-axis.

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 as transfer_size) from the results.
A timeseries avg(dt.host.cpu.usage) query returns a single timeseries for avg(dt.host.cpu.usage). That timeseries is then the only selectable option in the list.
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 as Kilobyte and Megabyte. 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.
Turn on Abbreviate large numbers if you want to display large figures in abbreviated form. For example, 1053 becomes 1.1K.

To reset to defaults (discard override settings for the selected item), select the trash can Delete 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 as One to instead display the result as a fraction of 1.
- Displayed unit displays Auto. You can change it to a different unit, such as One 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) into Degree Fahrenheit(°F), or convert Usd(US$) into Eur(€).
- 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 Delete 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 Delete 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.