Alarm Status Indicator

Who it’s for

Anyone building a dashboard around a zone, room, machine, or fleet needs one fast answer to “is everything OK right now?” A shift supervisor watches a wall display, a facility engineer checks one specific room, a technician glances at their phone before heading to a site, and an executive scans a grid of tiles across many locations at once — none of them want to read a table of individual alarms just to get that answer.

What it does

A room with two Warning alarms and one Critical alarm shows a single red Critical tile with a count of 3. The moment the Critical alarm clears, the tile switches to amber Warning with a count of 2, and once nothing is active, it settles into a calm green Normal tile reading 0.

• Shows the single highest active severity — Critical, Major, Minor, Warning, or Indeterminate — as one color-tinted tile with a matching icon and label
• Shows a live count of how many active alarms currently match the filter
• Falls back to a calm Normal tile, not an empty or error-looking screen, the moment zero alarms match the filter
• Tells apart “no alarm source bound yet,” “bound, but nothing has loaded yet,” and “bound, and there’s genuinely nothing active” — three different states, not one generic blank
• Shows one status for the whole alarm source; it does not list individual alarms, and it does not let you drill into them

How to set up

Alarm source and filter

Setting	Default	Effect
Alarm source (Data tab)	None — must be set	The single entity or entity alias whose alarms are watched
Alarm filter — severity, status, type (Data tab)	No restriction (any status, every severity and type)	The only place filtering happens; the widget has no filter controls of its own

Add the widget to a dashboard state, then set the alarm source and, if you want to narrow it, the alarm filter — both live on the Data tab, the same place any alarm widget configures them. With a source bound and nothing narrowed, the tile shows the current alarm state right away, using the default colors, icons, and labels for all five severities and for Normal.

How to customize

• To change how a severity looks — set its Color, Label, and Icon under Settings → Severity appearance (one identical group per severity, so changing Critical never affects how Major looks).
• To change the “all clear” look — set Color, Label, and Icon under Settings → Normal state.
• To hide the severity icon — turn off Show severity icon under Settings → Display.
• To hide the alarm count — turn off Show active alarm count under Settings → Display.
• To make the tile background stronger or more subtle — adjust Background tint opacity (0-1) under Settings → Display; the active severity or Normal color is used at this opacity for the background, while the icon, label, and count stay at full solid color.
• To restyle the text — adjust Label font and Count font under Settings → Display.

Tips

• Give Minor and Warning their own distinct colors rather than reusing one — all five severities are treated equally, so sharing a color between two of them is the one way to make them look like the same state.
• Because filtering lives on the Data tab, editing the alarm filter later updates this same widget instance automatically; there is nothing to touch in its own settings.
• Pair this tile with an alarms table on the same dashboard for the underlying detail — this widget deliberately shows only the worst active severity, not the full list behind it.