Dataset Status Indicator #

Introduction #

The Dataset Status Indicator is a compact tile that displays the most recent value from a single dataset along with its unit. It is designed for at-a-glance status monitoring on dashboards and can change its text and background colors based on configurable value ranges, making it equally useful as a live readout and as a visual alert.

Features #

  • Displays the latest dataset value with its unit and decimal precision
  • Configurable value-range highlights with custom text and background colors
  • Inclusive or exclusive bounds for each range
  • Stale-data detection via maxAge — older readings are flagged visually
  • Optional tooltip showing the value’s timestamp or a custom message
  • Configurable auto-refresh via updateFrequency (in seconds)
  • Supports stringValueMapper to display human-friendly labels for numeric codes (e.g., 1 → "On")
  • Theme-aware default colors

Use Cases #

  • Showing the current reading of a sensor, meter, or KPI
  • Color-coded threshold monitoring (safe / warning / critical)
  • Surfacing on/off, open/closed, or other state mappings as readable labels
  • Acting as a connectivity check via stale-data highlighting
  • Embedding live status tiles next to charts or tables for context

Example #

Dataset Status Indicator