Overview
The gauge node displays single values with visual indicators.
Supports various gauge types including speedometer, level indicator, donut, compass, and wave.
Perfect for showing sensor readings at a glance.
Gauge
Speedometer
Level
Tank Fill
Donut
Percentage
Wave
Animated
Properties
| Property | Type | Default | Description |
|---|---|---|---|
| group | string | - | Dashboard group |
| gaugeType | string | "gauge" | gauge, donut, level, wave, compass |
| min | number | 0 | Minimum value |
| max | number | 100 | Maximum value |
| units | string | "" | Unit label (°C, %, etc.) |
| segments | array | [] | Color segments for ranges |
Gauge Types
Gauge (Speedometer)
Classic dial gauge
Donut
Circular progress
Level
Tank/battery level
Color Segments
Define color ranges to indicate status.
// Gauge node configuration
{
"min": 0,
"max": 100,
"segments": [
{ "from": 0, "to": 30, "color": "#22c55e" }, // Green (OK)
{ "from": 30, "to": 70, "color": "#eab308" }, // Yellow (Warning)
{ "from": 70, "to": 100, "color": "#ef4444" } // Red (Critical)
]
}
// Temperature gauge example:
{
"min": -10,
"max": 50,
"units": "°C",
"segments": [
{ "from": -10, "to": 15, "color": "#3b82f6" }, // Cold (Blue)
{ "from": 15, "to": 25, "color": "#22c55e" }, // Normal (Green)
{ "from": 25, "to": 35, "color": "#f97316" }, // Warm (Orange)
{ "from": 35, "to": 50, "color": "#ef4444" } // Hot (Red)
]
} Example: CPU Temperature Monitor
Display CPU temperature with color-coded zones.
// Input to gauge node:
msg.payload = 67; // Temperature in °C
// Gauge configuration:
{
"label": "CPU Temperature",
"gaugeType": "gauge",
"min": 20,
"max": 100,
"units": "°C",
"segments": [
{ "from": 20, "to": 50, "color": "#22c55e" },
{ "from": 50, "to": 75, "color": "#eab308" },
{ "from": 75, "to": 100, "color": "#ef4444" }
]
}
// The gauge will show 67°C in the yellow/warning zone Input Formats
Simple Number
msg.payload = 42; With Label Override
msg.payload = 42;
msg.ui_control = {
label: "New Label"
};