Alarm count
Displays the number of alarms based on the selected filter.
Who it’s for
Operators and shift leads who need to know how much is wrong right now, before they look at what is wrong. The tile sits at the top of an operations dashboard and answers one question — is the alarm load normal for this time of day, or has something changed — with the alarm table underneath supplying the detail.
What it does
The Alarm count card counts the alarms matching a filter and prints the total with a caption and an icon. With the default filter of active alarms, a site holding three unresolved faults shows a warning icon on a teal badge, the caption Total, and 3 beside it; when the count climbs, the badge color can climb with it.
- The filter defines the number — alarm status, severity, type and assignee all narrow what is counted, so one dashboard can carry a Critical tile next to an Assigned to me tile fed by the same entities.
- The icon badge can react to the count — its color accepts ranges, which turns the tile into a signal that changes at a threshold rather than a number someone has to read and judge.
- Column or row layout puts the caption above or beside the number, so the tile works in a narrow sidebar or a wide header band.
- An optional chevron marks the tile as clickable, so the count leads to the alarm list it summarizes.
- Caption, value and icon each take their own font and color.
- The Alarm count card reports a total: it names no alarm, shows no severity breakdown and lists nothing, so it belongs above an alarm table rather than instead of one.
How to set up
Data keys
The Alarm count card takes no data keys — it counts alarms rather than reading telemetry.
| Key | Role | Type | Description |
|---|---|---|---|
| — | No key is read | Entity field | What the card counts comes from the datasource’s entity alias and its alarm filter. The alias picks the entities whose alarms are in scope; the filter narrows those alarms by status, severity, type and assignee. |
Alarm filter
| Setting | Default | Effect |
|---|---|---|
| Status | ACTIVE | Which alarm states count — active, acknowledged, cleared, or a combination |
| Severity | Unset | Restricts the count to chosen severities; unset counts all |
| Alarm type | Unset | Restricts the count to named alarm types |
| Assigned to current user | Off | Counts only alarms assigned to whoever is viewing the dashboard |
Set the alias first, then the filter, and check the number against the alarm table fed by the same alias. A tile counting every status is a different measurement from one counting only active alarms, and the caption is the only thing on the card that says which.
How to customize
- To put the caption beside the number instead of above it — set Layout to Row; Column stacks them.
- To keep the tile proportional at any size — leave Auto scale on; turn it off to pin exact font sizes.
- To say what is being counted — turn on Label and replace the default Total, which describes nothing on a dashboard holding several count tiles.
- To make the badge change color as alarms accumulate — set Icon background color to a range, so the tile shifts from calm to urgent on its own.
- To change the symbol — set Icon to any Material or MDI name and adjust its size and color; the badge behind it has its own size.
- To make the number itself react — set Value color to a range instead of a constant.
- To mark the tile as clickable — turn on Chevron and attach a click action opening the matching alarm list.
Tips
- Pair a wide All active tile with narrow Critical and Major tiles fed by the same alias. The totals then decompose at a glance, and a rising critical count is visible even while the overall total stays flat.
- Put the threshold in the badge color rather than expecting anyone to judge the number. Whether
12is normal depends on the site, and encoding that judgement once in a color range beats re-explaining it to every new operator.
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.