Gauge visualization (SmartViz)

Important

This feature is in beta and subject to change. Reach out to support with any issues.

The Gauge visualization shows a single value against a range, optionally with colored bands marking healthy and unhealthy territory and a marker showing a target.

When to use a gauge

A gauge puts one number in context against a range. It earns the space only when the range itself carries meaning: a percentage, an SLA target, a budget ceiling. For a number with no natural maximum, a Scalar says the same thing in less room.

Utilization against a limit is the typical use: Average CPU Percentage from Azure, or Service Quotas from AWS to show how close a resource sits to its cap.

Set Color bands so the reader doesn't have to interpret the number themselves. For many gauges at once, a Gauge list is far more compact.

Try it out

Change the settings below and see how the chart updates. Select a dataset from the dropdown to see different use cases.

Interactive example
Showing

Quota attainment per rep, where more is better, so the bands run red up to green. The target sits at 100% and crossing it is the whole point of the gauge.

10082%0120
Gauge: 82% of 0–120%, target 100%

Gauge settings

Data mapping

Setting
Description
Value
Required. Select the numeric column providing the gauge's value.
Min
Select a numeric column supplying the bottom of the range. This takes precedence over the Min Value setting.
Max
Select a numeric column supplying the top of the range. This takes precedence over the Max Value setting.
Target
Select a numeric column supplying the position of the target marker.

Legend & labels

Setting
Description
Show Data Labels
Enable to display the value on the gauge.
Label Color
Choose the text color for the value label.
Label Font Size (px)
Enter the font size for the value label, from 6 to 72.
Label Format
Enter an Expression to format the label content. Use {{value}}, {{name}}, or a column name. The date, number, and percent helpers are available.

Gauge

Setting
Description
Full Circle
Enable to draw the gauge as a complete circle rather than an arc.
Show Tick Marks
Enable to display minor tick marks around the gauge.
Show Split Lines
Enable to display the major division lines around the gauge.
Show Scale Labels
Enable to display the numeric scale around the gauge.
Min Value
Enter a fixed minimum for the range. A mapped Min column overrides this value.
Max Value
Enter a fixed maximum for the range. A mapped Max column overrides this value.
Target Marker Color
Choose the color for the target marker.
Label Text
Enter a custom label to display with the gauge, for example CPU Usage.

Color bands

Color sections of the gauge's arc. Each band colors the range up to its to value, expressed as a fraction of the full range between 0 and 1. List the bands in ascending order, and end the last band at 1.

Setting
Description
to
Enter the upper bound of the band, from 0 to 1. A band with a to of 0.75 covers everything up to 75% of the way between the minimum and maximum.
Color swatch
Choose the color applied to that section of the arc.

Was this article helpful?

Have more questions or facing an issue?
Submit a ticket