Skip to main content

Aggregated State Widget

Aggregated State Widget

Overview​

The Aggregated State widget displays aggregated state information across multiple data points or Things. It provides a consolidated view of states, useful for monitoring groups of devices or summarizing multiple measurements.

Use Cases​

  • Fleet Monitoring - Overview of multiple device states
  • Group Status - Aggregate status for device groups
  • Multi-Sensor Summary - Combined state from multiple sensors
  • Facility Overview - Overall facility status from multiple sources
  • Performance Summaries - Aggregated performance metrics

Key Features​

  • Multi-source data aggregation
  • Configurable aggregation methods
  • Time-based aggregation
  • Visual state indicators
  • Real-time updates

Configuration​

Basic Settings​

FieldRequiredDescription
Name❌ NoDisplay name for the widget
Thing✅ YesSelect Thing to aggregate from
Measure✅ YesChoose measure to aggregate (with id, measure, thingId)
Aggregation Method✅ YesAverage, sum, min, max, count, etc.

Timeframe Settings​

FieldRequiredDescription
Window✅ YesTime window configuration with type, from, to
Bucket❌ NoBucket size for cumulative aggregations
Override❌ NoUse widget-specific time settings instead of dashboard defaults

Display Options​

FieldRequiredDescriptionDefault Value
Mode❌ NoDisplay mode: 'carousel' or 'stacked'-
Orientation❌ NoLayout: 'horizontal' or 'vertical'-
Compact number❌ NoDisplay large numbers compactlytrue
Gapfill❌ NoFill gaps in data-
Transparent❌ NoRemove widget backgroundfalse
Border color❌ NoWidget border color-
Background Color❌ NoWidget background color-

Best Practices​

  1. Meaningful Aggregation - Choose aggregation method that makes sense for data
  2. Device Grouping - Aggregate similar devices or measurements
  3. Time Periods - Use appropriate time windows for aggregation
  4. Trend Analysis - Compare aggregated states over time
  5. Clear Labeling - Indicate what is being aggregated

What's Next?​