--- title: Basic gauges description: Create a customized gauge visualization in Custom Dashboards. url: https://coralogix.com/docs/user-guides/custom-dashboards/widgets/gauges/basic-gauges/ product: dashboards feature: Dashboards feature_id: dashboards feature_identifier: dashboards/dashboards last_updated: '2026-11-03' --- # Basic gauges Create a customized gauge visualization in [Custom Dashboards](https://coralogix.com/docs/user-guides/custom-dashboards/introduction.md). ## 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. [![](/docs/assets/images/Gauge_CPU_usage-f6fc14b9b38ba75dd94524a45e2199c2.webp)](https://coralogix.com/docs/assets/images/Gauge_CPU_usage-f6fc14b9b38ba75dd94524a45e2199c2.webp) ## 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](https://coralogix.com/docs/user-guides/custom-dashboards/tutorials/query-builder.md). **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 widget parameters Define the parameters for your widget in the right-hand sidebar. ### General settings Define the parameters for your 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**. Use **Legend by** to set how the legend organizes and displays information. It's available for every query source, including DataPrime. * **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 management**. Use **Arc display** to show or hide the gauge arcs, then enable or disable each arc individually. * The **Value arc** is the thick outer arc that fills to show the current metric value. * The **Threshold arc** is the thin inner arc that displays the threshold zones you have defined. If you turn off both arcs, **Arc display** turns off. Turning **Arc display** back on shows both arcs again. If you disable both arcs, the widget displays the numeric result of your query as a stat value. You can then control whether the threshold color applies to the value or the background. **Values display**. Toggle **Min Max** to label the gauge with its minimum and maximum values, placed at the start and end of the arc. The labels appear while either arc is displayed. **Threshold color**. Set the color/s for the **values** and **background** in your visualization. ### Query parameters **Group by**. If you wish to generate multiple gauges, incorporate the `group by` functionality in your query. See our Multi-Gauge documentation [here](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/gauges/multi-gauges.md). **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. When left empty, the fields show the current data-inferred range as a placeholder hint, so you can preview the auto-scaled range before overriding it. * **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. Select **Custom unit**, then enter the text to append. The gauge shows it after the value, so a custom unit of `FG` renders as `232.87K FG`. [![Gauge reading 232.87K FG beside the Units management panel, where Units is set to Custom unit and the Custom Unit field contains FG](/docs/assets/images/gauge-custom-unit-fbe978f4c3744a04ff5337c7f6b672d4.webp)](https://coralogix.com/docs/assets/images/gauge-custom-unit-fbe978f4c3744a04ff5337c7f6b672d4.webp) * **Decimal**. Specify the number of decimals displayed in the calculated value, from 0 - 15. * **Precision**. Toggle **Precision** to display the full, unrounded numerical value inside the gauge. When disabled, the values are shortened for readability using unit-based formatting, based on the selected **Decimal** setting. **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. [![Gauge widget beside the Units management and Thresholds panels, showing Min 0 and Max 100 with relative thresholds at 33 and 66 percent](/docs/assets/images/gauge-thresholds-5ac55ac5426257f42d24c7371c5a5966.webp)](https://coralogix.com/docs/assets/images/gauge-thresholds-5ac55ac5426257f42d24c7371c5a5966.webp) The gauge above reads `473.82K` against a **Max** of `100`. A value past the top of the range fills the value arc completely and takes the color of the highest threshold it has passed. 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 **Relative** and **Absolute**. * **Relative**: evaluated as a percentage of the range between **Min** and **Max**. * **Absolute**: evaluated as an exact number. ## Next steps Learn how to use [Multi-Gauges](https://coralogix.com/docs/user-guides/custom-dashboards/widgets/gauges/multi-gauges.md) to display multiple gauge values in a single widget.