Skip to main content

gauge

Display single values with visual indicators like speedometers and progress bars.

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"
};

Related Nodes