• Home
  • How to use Dynatrace
  • Dashboards and reports
  • Charts and tiles
  • Configure and use a graph visualization in Dynatrace

Configure and use a graph visualization in Dynatrace

Shows query results as a graph. A graph can show up to 20 series per metric.

Example graph in the Data explorer

Graph with two metrics

Example graph tile

Example chart tile

Change selection of metrics

Your visualization can show any selection of metrics in a multi-metric query. The letter next to each metric in your query toggles display of that metric on or off.

In this example, you would change the selection from A (CPU usage % only) to both A and B (CPU usage % and Memory used %).

Change metric selection

Visual settings

Visualization

You must select Graph to display this type of visualization.

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, 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.

Custom resolution

Show legend

Whether to display a legend under the visualization.

Note that the legend is active: you can select a legend entry to toggle display of the corresponding entry on or off.

Connect gaps

To connect gaps in a chart, in the Visual settings section, turn on Connect gaps.

Connect gaps: before

Connect gaps: before

Connect gaps: after

Connect gaps: after

Per-metric visual settings

The Visual 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.

  1. In the Visual settings section, select Edit pen icon for the metric you want to rename.
  2. Edit the name, and then select the checkmark to save the new name.

Change chart mode

To change the chart mode for a metric, in the Visual settings section, select a new chart mode from the list.

  • Line
  • Column
  • Area

Change color palette

To change the color palette for a metric, in the Visual 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.

Unit

Use the Unit setting to set the unit in which the metric is displayed.

  • None = No unit displayed
  • Auto = 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.

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, where None would display 5.062357754177517 %, Auto would display 5.06 %.
  • Other selections specify the number of decimal places to display: 0, 0.0, 0.00, 0.000

Examples

Example: bytes

When the basic unit of the metric is byte:

  • If you set Unit to Auto, Dynatrace automatically expresses the results in a human-readable unit, which in this case could be GiB.
    Note: A byte-based unit can have either a binary or decimal base, which will determine whether Dynatrace selects, for example, GiB or GB. If no base is defined in the metric itself, a decimal base is used.
  • If the automatically selected unit isn't suitable in your case, you can force Dynatrace to express the same values in a specific unit (Unit = B, KiB, or MiB).
  • If you want to see raw data (no conversion), you can set Unit to None and see the results in the basic unit of the metric (which in this case is bytes).
Example: dollars and cents

When the basic unit of a metric is dollars and cents:

  • For smaller values, to see the results expressed in exact dollars and cents: set Unit to Auto, and set Format to 0.00 (to have two decimal places for the cents)
  • For larger values, to see the results expressed in thousands, millions, or billions of dollars and no cents: set Unit to k, mil, or bil, and set Format to 0 (to see nothing after the decimal point).
Example: exact counts

When the basic unit for the metric is a count:

  • To see an exact count: set Unit to Auto, and set Format to None.
  • To see a rough count: set Unit to something like k, mil, or bil (depending on the magnitude of your values), and set Format to 0.0, 0.00, or 0.0000 (depending on how many decimal places make sense in combination with the selected Unit setting).
Example: thresholds

When setting threshold values:

  • If you select a Unit (for example, MiB), the Threshold settings are then prepared to match the selected unit, so you just need to enter threshold values without specifying MiB.
  • If you set Unit to Auto (to let Dynatrace automatically scale the displayed output), you still need to set Threshold values in a specific unit such as bytes.

Add color override

To force a different color (override the color palette) for a specific series such as a selected host

  1. In the Visual settings section, select Add color override
  2. Select the series from the list
  3. Select the override color for that series

Axes

In the Axes section, you can control how the X axis and each Y axis of your visualization are displayed.

Walkthrough of axis settings

In this walkthrough, you add some metrics to a visualization and see how to adjust the axis settings in the Axes section of the Settings for your graph. (This example uses a Graph visualization, but the same settings apply to other visualizations that have axis settings.)

  1. In the Dynatrace menu, go to Data explorer.

  2. In the Data explorer, add metric builtin:host.mem.used, split by Host, and select Run query.

    • The X axis, which is displayed along the bottom of the graph, is the current timeframe as determined by the timeframe selector.
      • The X axis has no name by default, but you can name it: in the Axes section, find X axis, select Edit pen icon in the X axis row, change the name (for example, to Time), and then select the checkmark to save the new name.
      • To toggle the display of the X axis on and off, select Preview in the X axis row.
    • The Y axis by default is displayed up the left side of the graph.
      • There can be more than one Y axis on a chart. The first one is automatically labeled Y axis 1 in the Axes section. In this example, it displays memory used in GB, corresponding to the first metric you have added to your chart, Memory used (builtin:host.mem.used).
      • As with the X axis, you can name and hide/show the Y axis: find Y axis 1 in the Axes section and select Edit pen icon and Preview accordingly.
      • To move the Y axis to the right of the chart, change Position from Left to Right.
      • To specify the range of a Y axis, change Min, Max from Auto, Auto to numeric values. For example, set Min, Max for this metric (Memory used) to 5, 10 to chart values between those values.

    One Y axis

  3. Select Add metric and add metric builtin:host.cpu.usage, split by Host, and select Run query again.

    • The Y axis for the second metric (CPU usages %) is displayed up the right side of the graph to indicate CPU usage percentage. (If you moved the Y axis in the previous step, now they both run up the same side of the chart.)

    • In the Axes section, a new Y axis 2 section is displayed.

      Two Y axes

Additional Y axes are not created automatically for any subsequent metrics you add to the chart, but you can add them manually: after you add the metric to your query, select Add Y axis in the Axes section, select in the empty Axis Metric box, and then select the metric you want to display for the new axis. Below, a third metric has been added with a third Y axis for .NET memory consumption (Large Object Heap).

Three Y axes

Name an axis

To name an axis

  1. In the Axes section, find the axis you want to rename.
  2. Select Edit pen icon next to the axis name.
  3. Enter a new name and select the checkmark to save the change.
    The axis name is displayed vertically next to a Y axis and horizontally under the X axis.

Hide or show an axis

To hide an axis

  1. In the Axes section, find the axis you want to hide.
  2. Select Preview.
    To unhide the axis, select Preview again.

Define an axis position

To specify the side of the chart on which to display a Y axis

  1. In the Axes section, find the Y axis you want to move.
  2. Set Position to Left or Right.

Set an axis minimum and maximum

By default, minimum and maximum axis values are set automatically.

To set custom minimum and maximum values for an axis

  1. In the Axes section, find the axis for which you want to define a minimum and maximum.
  2. Change the value of Min, Max from Auto, Auto to a comma-separated pair of values corresponding to the values on the selected axis.

Thresholds

To enhance your visualizations, you can set thresholds that are reflected in your visualization.

This example shows a Graph visualization of CPU usage % (builtin:host.cpu.usage) before and after adding thresholds. The effect is similar for other visualizations with thresholds.

Graph - no thresholds

Data explorer graph - no thresholds

Same graph with thresholds added

Data explorer graph - thresholds

The thresholds also affect how the tiles are displayed on your dashboards.

Graph tile before and after thresholds

Dashboard tile - graph before and after thresholds

Set thresholds

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.

To set thresholds

  1. In the Thresholds section, enter threshold values

    Set threshold values

  2. Adjust threshold colors optional

    Adjust the threshold colors

Hide or show threshold colors

To hide or show threshold colors without deleting the threshold settings, in the Thresholds section, select Preview.

Hide or show thresholds