Skip to content
Stand with Ukraine flag

Alarms count by severity

  • Widget
  • 6 installs
  • v1.0.0
  • Aug 17, 2026
  • MIT license
  • v4.2+
Alarms count by severity

Shows live alarm counts for all five severities, plus a total, as color-coded tiles with icons.

Widget Type
  • Alarm
Category
  • Cards & Info
Use Cases
  • Smart Building
  • Smart City
  • Smart Energy
  • Air Quality Monitoring
  • Asset Tracking
  • Environment Monitoring
  • Tank Level Monitoring

Who it’s for

For anyone whose first question on opening a dashboard is “what am I actually dealing with right now?” — a dispatcher deciding what to work on first, a shift lead checking what piled up overnight, a regional manager scanning one tile per site to spot where alarms are concentrating, a service company tracking Critical count as the number their SLA lives or dies by, or a network operator watching for early signs like a rising Minor count, which often precedes a Critical one.

What it does

Reads the active alarms matched by whatever alarm source and alarm filter are configured on the widget’s Data tab, then renders one tile per severity plus a Total tile, all in the same equal layout:

  • One tile each for Total, Critical, Major, Minor, Warning, and Indeterminate — live count, small icon, and label, colored to match.
  • All five severities always render, even at zero — a severity with no active alarms shows “0,” not nothing, so the full scale stays visible.
  • Total is configured exactly like every severity (its own color, label, and icon) and sits inline with them, not as a separate header element.

How to set up

  1. Add Alarm Count by Severity to a dashboard state.
  2. On the widget’s Data tab, assign an alarm source: a single entity, or an entity alias covering a group.
  3. In the alarm filter section of that same Data tab, choose which severities, statuses, and alarm types should count — this is the only place filtering happens; the widget has no filter controls of its own.
  4. That’s it — the widget shows live counts for Total and all five severities automatically, using sensible default colors, icons, and labels.

How to customize

  • To change how a severity or Total looks — set its Show, Label, Color, and Icon under Settings → Alarm counts. Each is an independent group, so changing Critical never affects Major, and hiding one tile never affects the others’ layout.
  • To hide all icons at once — turn off Show icons under Settings → Display.
  • To make tile backgrounds stronger or more subtle — adjust Tile background tint opacity (0-1) under Settings → Display; each tile’s color is used at this opacity for the background, while the count, label, and icon stay at full solid color.
  • To restyle the text — adjust Label font and Count font under Settings → Display.

Notes

  • No telemetry or attribute keys are read — the widget is driven entirely by ThingsBoard’s own alarm subscription, so there’s nothing to wire up beyond the Data tab’s alarm source and filter.
  • Because filtering lives on the Data tab, the same widget instance updates automatically if the alarm filter is changed later — no need to touch widget settings to change which alarms it counts.

Share Your Widget with the Community

Built a custom widget? Export it as a JSON from ThingsBoard and publish it to the IoT Hub through a simple 4-step wizard (Upload, Listing, Readme, Review & Submit). Share it with thousands of ThingsBoard developers worldwide and get featured in the catalog.