Gauge
Gauge shows a value calculated from source rows on a fixed range, with an optional target and status zones.
Show team utilization
The support team's one row of utilization, 72%, sits on a fixed range from 0% to 100%.
Gauge interactive example
Loading interactive example…
The live example needs a desktop screen. The result it produces is shown here, and the explanation and settings below work on any screen.
| Resource | Utilization percent |
|---|---|
| Support team | 72 |
- In the Data tab, change Operation from
AveragetoMaximumto see the highest value on the same range. - Expand Range and change the minimum or maximum. The arc fills to a different point.
- Expand Target to add a marker for a target value.
When to use
Use Gauge when the range gives the value its meaning, such as utilization, where 72% only makes sense between empty and full. To show progress toward a goal, use Progress. If there's no fixed range, Number is enough.
Inputs
- Table
Accepts: Tables.
Accepts one connection on this port.
Settings
- Value
Field to calculate. Automatic picks one, and Count rows needs none.
- Operation
How the source rows become one value. Missing values are skipped.
Default:
SumOptions: Sum, Average, Median, Minimum, Maximum, 25th percentile, 75th percentile, 90th percentile, 95th percentile, Percentile, First by time, Last by time, Count values, Count distinct, Count rows, Count true, Percentage true.
- Label
Text of the label.
37 more settings
- Show target
Shows or hides the target.
Default:
false- Minimum
Lowest value on the scale.
Default:
0- Maximum
Highest value on the scale.
Default:
100- Source timezone
IANA time zone for timestamps without an offset, such as Europe/Copenhagen. Ambiguous local times need an explicit offset.
Default:
UTC- Chart timezone
IANA time zone used for grouping and display. Vista filters keep their own time zone.
Default:
UTC- Week starts
Day the week starts on.
Default:
MondayOptions: Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday.
- Fiscal year starts
Month the fiscal year starts in. Sets quarter and year boundaries.
Default:
JanuaryOptions: January, February, March, April, May, June, July, August, September, October, November, December.
- Show tooltip
Shows or hides values when you hover over a mark.
Default:
true- Content
Use the automatic details, or write your own text with calculated values.
Default:
AutomaticOptions: Automatic, Custom.
- Goal
Whether higher, lower or staying inside a range is good.
Default:
Higher is betterOptions: Higher is better, Lower is better, Within a range.
- Show status
Gives the value a status using limits you set in its own units.
Default:
false- Horizontal alignment
Alignment of the content.
Default:
CenterOptions: Left, Center, Right.
- Vertical alignment
Vertical position of the content in the card: top, center or bottom.
Default:
CenterOptions: Top, Center, Bottom.
- Value size
Size of the value.
Default:
28- Label size
Size of the label.
Default:
12- Value color
Color of the value.
- Label color
Color of the label.
- Show value
Shows or hides the value.
Default:
true- Show label
Shows or hides the label.
Default:
true- Content spacing
Space between the parts of the card, in pixels (0-80).
Default:
6- Supporting text size
Auto (0) matches Label size. Otherwise 10-80 pixels.
Default:
0- Show minimum and maximum
Shows or hides the range labels. The range doesn't change.
Default:
true- Number format
Percentage shows fractions multiplied by 100. Calculations keep the original units.
Default:
AutomaticOptions: Automatic, Number, Percentage.
- Decimals
Number of decimal places.
Default:
0- Digit grouping
Groups digits, so 2630 shows as 2,630.
Default:
true- Prefix
Text before the value.
- Suffix
Text after the value. Adding % doesn't multiply the value by 100.
- Scale
Display unit for the value.
Default:
noneOptions: none, K, M, B.
- Accent color
Accent color.
- Track color
Color of the track.
- Shape
Shape of the gauge.
Default:
Half circleOptions: Half circle, Full circle.
- Arc thickness
Thickness of the arc.
Default:
12- Gauge size
How much of the available space the gauge fills, as a percent (10-100).
Default:
50- Rounded ends
Rounds the ends of the arc. Joins between ranges stay square.
Default:
false- Background
Card background color. Auto follows the theme.
- Corner radius (px)
Corner radius in whole logical pixels.
Default:
0- Border width (px)
Border width in whole logical pixels.
Default:
0
Gauge FAQs
- Where do I set the range?
- In the Data tab, under Range. This example uses 0 to 100.
- Can it show good and bad zones?
- Yes. Use Goal to set thresholds.
Chart your data. Build it in Vista.
Vista opens in your browser, with no account.