Skip to content

Gauges

Create a customized 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. It is typically used to represent key metrics and performance indicators at a glance.

Getting started

In a custom dashboard, click the + icon to add a widget. To get started, drag and drop the Gauge widget from your left-hand sidebar.

Select a data source

In the lower screen panel, select logs, metrics, or spans as your data source.

Build a query

Enter a PromQL query as the basis of your widget in the lower Query panel.

If you want to query metrics, specify the metric in the panel. Use free text to search for a metric of your choice. As you do so, all relevant metrics will appear. Hover over any metric to view its metadata labels. Hover over a label to see its values.

If you wish to generate multiple gauges, incorporate the group by functionality in your query. See our Multi-gauge documentation here.

Select a data pipeline

Select whether to load data from Frequent Search or Monitoring pipelines. Find out more here.

Define your gauge parameters

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

Name

Text entered in this field appears at the top of your panel in the panel editor and above the widget in the dashboard.

Description

Text entered in this field appears in a tooltip in the upper-left corner of the panel. Add a description to a panel to share important information with your team, such as its purpose.

Choose filter

[Optional] Add a filter 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.

Data management

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

AggregationDescription
CountThe total number of data points within the selected time range.
Count DistinctThe number of unique data points within the selected time range.
SumThe sum of all data points within the selected time range.
MinThe smallest value among the data points within the selected time range.
MaxThe largest value among the data points within the selected time range.
AverageThe average value of all data points within the selected time range.
Percentile XXRepresents 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.

CalculationDescription
InstantThe value at the current point in time.
LastThe most recent value within the selected time range.
MinThe smallest value within the selected time range.
MaxThe largest value within the selected time range.
AvgThe average value of all data points within the selected time range.
SumThe total sum of all data points within the selected time range.
NoneNo calculation is applied; raw data is used.

Units management

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

Visual management

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

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)

Support

Need help?

Our world-class customer success team is available 24/7 to walk you through your setup and answer any questions that may come up.

Feel free to reach out to us via our in-app chat or by sending us an email at [email protected].