---
title: Gauge visualization
description: The Gauge view displays the single value most recent value for a time series in a gauge view.
url: https://docs.influxdata.com/influxdb/cloud/visualize-data/visualization-types/gauge/
estimated_tokens: 593
product: InfluxDB Cloud (TSM)
version: cloud
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/cloud/visualize-data/visualization-types/gauge/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---

The **Gauge** visualization displays the most recent value for a time series in a gauge.

<img src="/img/influxdb/2-0-visualizations-gauge-example-8.png" width="470" alt="Gauge example">

Select the **Gauge** option from the visualization dropdown in the upper left.

## Gauge behavior

The gauge visualization displays a single numeric data point within a defined spectrum (*default is 0-100*).
It uses the latest point in the first table (or series) returned by the query.

#### Queries should return one table

Flux does not guarantee the order in which tables are returned.
If a query returns multiple tables (or series), the table order can change between query executions
and result in the Gauge displaying inconsistent data.
For consistent results, the Gauge query should return a single table.

## Gauge Controls

To view **Gauge** controls, click  **Customize** next to
the visualization dropdown.

* **Value Prefix**: Prefix to add to the gauge value.
* **Value Suffix**: Suffix to add to the gauge value.
* **Axis Prefix**: Prefix to add to the gauge axis.
* **Axis Suffix**: Suffix to add to the gauge axis.
* **Decimal Places**: The number of decimal places to display for the gauge.
  * **Auto** or **Custom**: Enable or disable auto-setting.

###### Colorized Thresholds

* **Add a Threshold**: Change the color of the gauge based on the current value.
  * **Minimum**: Enter the minimum value at which the gauge should appear in the selected color.
    Choose a color from the dropdown menu next to the value.
  * **Maximum**: Enter the maximum value at which the gauge should appear in the selected color.
    Choose a color from the dropdown menu next to the value.

## Gauge examples

Gauge visualizations are useful for showing the current value of a metric and displaying
where it falls within a spectrum.

### Steam pressure gauge

The following example queries sensor data that tracks the pressure of steam pipes
in a facility and displays it as a gauge.

###### Query pressure data from a specific sensor

```js
from(bucket: "example-bucket")
    |> range(start: -1m)
    |> filter(fn: (r) => r._measurement == "steam-sensors" and r._field == "psi" <INVALID_OP> r.sensorID == "a211i")
```

###### Visualization options for pressure gauge

<img alt="Pressure gauge example" width="766" src="/img/influxdb/2-0-visualizations-gauge-pressure-8.png">
