Multi-Gauges

Create a customized multiple-gauge visualization in Custom Dashboards.

Overview

A gauge is a visual tool that displays a single value within a specified range, often resembling a speedometer or dial, and is typically used to represent key metrics and performance indicators at a glance. Gauges incorporate thresholds which allow you to change the appearance of the visualization when certain values are met or exceeded. When you group a data set by a specific parameter, you create a multi-gauge, where each gauge represents a subset of the data. This enables simultaneous comparison of multiple metrics across different categories or groups, providing a broader view of performance.

Getting started

To add a widget to a custom dashboard, click the + icon. Then, drag and drop the gauge widget from your left-hand sidebar.

Use the Query Builder to create a query

In the bottom panel, build your query using Query Builder. If you wish to generate multiple gauges, incorporate the group by functionality in your query.

Aggregation. If you have chosen logs or spans as your data source, show an aggregated value using one of the following functions.

Aggregation	Description
Count	The total number of data points within the selected time range.
Count Distinct	The number of unique data points within the selected time range.
Sum	The sum of all data points within the selected time range.
Min	The smallest value among the data points within the selected time range.
Max	The largest value among the data points within the selected time range.
Average	The average value of all data points within the selected time range.
Percentile XX	Represents the value below which XX% of the data points fall. For example, Percentile 95 is the value below which 95% of data points fall.

Calculation. If you have chosen metrics as your data source, show a calculated value using one of the following functions.

Calculation	Description
Instant	The value at the current point in time.
Last	The most recent value within the selected time range.
Min	The smallest value within the selected time range.
Max	The largest value within the selected time range.
Avg	The average value of all data points within the selected time range.
Sum	The total sum of all data points within the selected time range.
None	No calculation is applied; raw data is used.

Define the parameters for your widget in the right-hand sidebar.

General settings

Define the parameters for your multi-gauge in the right-hand sidebar.

Add a filter. [Optional] Add one or more filters specific to the widget to narrow down the data displayed in your gauge. Select a label and its corresponding value. Note that filters applied at the widget level work alongside dashboard filters. If conflicts exist, the dashboard filters take precedence over widget filters.

Legend management. This parameter determines how the legend organizes and displays information.

Group organizes the legend based on different data entities, such as servers or applications, displaying each as a separate entry.
Threshold categorizes values based on predefined limits (e.g., normal, warning, critical), helping to visualize whether a metric is within an acceptable range or has crossed into a warning state.

Visual managment. Enable or disable the inner arc and outer arc. The inner arc displays the actual value for your query. The outer arc displays thresholds defined. If you choose not to enable either arc, the numerical result of your query will appear as a STAT widget without additional visualizations. In this case, you may determine whether the threshold color will be applied to the value or background.

Threshold color. Set the color/s for the values and background in your visualization.

Query parameters

Group by. The group by functionality is required in the query underlying the multi-gauge widget.

Units management. Manage the way units are displayed in your widget.

Min/Max. Set the minimum and maximum values used in percentage threshold calculations. You may choose to enter a static range of numbers or a range between 0-1 or 0-100.
Units. Choose one of the unit types or create a custom unit. Custom units are not added to a list of units, but are saved with the specific widget.
Decimal. Specify the number of decimals displayed in the calculated value, from 0 - 15.

Thresholds. A threshold is a value you set for a number that, when met or exceeded, changes the visualization's appearance based on the query results. Choose the base Thresholds – that is, when the gauge should appear green and red. Add additional thresholds if necessary. You may choose between percentage or absolute numbers.

Set the following options:

Value. This is the value that triggers the threshold. You can assign a specific color to this value.
Labels. Add labels to each threshold. For example, you may choose the label "good" for the base green threshold.
Threshold type. Choose between absolute and percentage.
- Absolute: Defined by a specific number
- Percentage: Relative to the minimum or maximum value (e.g., 80 percent)

Basic Gauges

Next Polystat Widget