---
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/v2/visualize-data/visualization-types/gauge/
estimated_tokens: 736
product: InfluxDB OSS v2
version: v2
publisher: InfluxData
canonical: https://docs.influxdata.com/influxdb/v2/visualize-data/visualization-types/gauge/
date: '2025-04-02T15:54:32-06:00'
lastmod: '2025-04-02T15:54:32-06:00'
---
This page documents an earlier version of InfluxDB OSS.[InfluxDB 3 Core](/influxdb3/core/) is the latest stable version.
#### API token hashing is enabled by default in InfluxDB OSS 2.9.0
Stronger token security: tokens are stored as hashes on disk, so a
copy of the database file doesn’t expose usable tokens. Existing
tokens are hashed on first startup and the original strings can’t
be recovered afterward — **capture any plaintext tokens you still
need before you upgrade**.
For more information, see [Token hashing](/influxdb/v2/admin/tokens/#token-hashing).
The **Gauge** visualization displays the most recent value for a time series in a gauge.
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" r.sensorID == "a211i")
```
###### Visualization options for pressure gauge
