Skip to content

Cookie preferences

We use cookies for our own analytics, to see how our campaigns perform and, if you allow it, to load content from other services such as the Google site search. We never sell your data. Necessary cookies keep the site working and cannot be switched off. See our Cookie Policy for details and our Privacy Policy for how we handle personal data.

Security, load balancing and remembering your cookie choice.

Show us which pages people read, how they find the site and where they get stuck, so we can improve it (Google Analytics, Microsoft Clarity).

Show us which of our ad campaigns bring visitors to the site and remember the campaign or partner link you arrived from (Google Ads, LinkedIn, Meta, partner program). We do not use these cookies to build advertising profiles.

Load the site search from Google when you use it. Google sets its own cookies and shows ads in the search results.

© 2026 The ThingsBoard Authors

ThingsBoard Cloud

Choose your data region

Your data stays in the region you choose, for residency and compliance. No credit card required.

Rather run it yourself? Install on your own servers

Alarms by severity

  • Widget
  • 12 installs
  • v1.0.0
  • Nov 17, 2026
  • MIT license
  • v4.2+

How bad is it right now? One glance answers: every severity gets a row with its count and a bar in the platform’s own colors, scaled against the largest group, so a single critical stands out next to a pile of minors. A line underneath says how many are still waiting for someone, such as 4 of 5 unacknowledged, and a View all link in the header opens your alarm page or table. Severities with no alarms drop out, keeping the card calm.

Widget Type
  • Alarm
Category
  • Cards & Info
  • Charts & Graphs

Who it’s for

The Alarms by severity card is for whoever opens an overview dashboard and needs to know how bad things are right now: an operator at the start of a shift, a facility manager checking a site between meetings, an on-call engineer deciding whether to drop what they are doing. The question is “is anything critical, and has anyone picked it up yet?”, and the card answers it before the alarm table has finished loading.

What it does

A street lighting overview shows eleven active alarms: two critical, five major, three minor and one warning. The Alarms by severity card draws one row per severity with its count and a bar scaled against the largest group, so the five majors fill the bar and the two criticals stand out in red at under half its length. Underneath, “7 of 11 unacknowledged” says how many are still waiting for someone, and a View all link in the header opens the full alarm list.

  • Counts the alarms per severity, Critical, Major, Minor, Warning and Indeterminate, always in that order, in the platform’s own severity colors.
  • Scales each bar against the largest group, so the shape of the problem is visible at a glance even when the numbers are small.
  • Says how many alarms nobody has acknowledged yet, or “All 5 acknowledged” when the team is on top of it.
  • Leaves out severities with no alarms, so a quiet site shows a short card instead of a column of zeros.
  • Shrinks its text, bars and spacing together when the card is too small for them, so it stays readable from a phone to a wall display.
  • Counts and summarizes. It does not list the individual alarms, and it does not let anyone acknowledge or clear them. That is what the alarm table it links to is for.

How to set up

Data keys

The Alarms by severity card takes no data keys. Like any alarm widget, it reads alarms from its alarm source on the Data tab: one entity, an alias or the whole tenant. From each alarm it reads two fields:

  • Severity — decides which row the alarm counts towards. An alarm with an unknown severity counts as Indeterminate.
  • Acknowledged state — decides whether it counts as unacknowledged in the line under the bars.

Alarm filter

The alarm filter on the Data tab decides which alarms are counted. It ships set to Active alarms, including alarms propagated from child entities. Change it to count cleared alarms as well, to keep only certain alarm types or severities, or to show only the alarms assigned to the current user. Clearing every status counts alarms of any status.

The card uses its own time window, the last 30 days, rather than the dashboard’s, so the dashboard’s period picker does not hide an alarm that has been active for longer. Up to 1,000 alarms are counted.

Actions

  • View all link — not set by default. Bind it on the Actions tab, usually to a dashboard state holding the alarm table. The link appears in the header only once an action is set, so it is never a link that does nothing.

How to customize

  • To keep every severity on the card, even at zero — turn on Show empty severities. The card then always has five rows and never changes shape.
  • To use your own severity colors — set Critical, Major, Minor, Warning and Indeterminate.
  • To make the bars thicker or thinner — set Bar thickness, 10 px by default, between 2 and 32. Track color sets the empty part of the bar behind the colored one.
  • To change the text — set Label font for the severity names, Count font for the numbers and Text color for both.
  • To drop the line under the bars — turn off Show summary.
  • To rename the header link — set Link text, View all by default, for example to Open alarms.

Tips

  • Put the Alarms by severity card next to a map or a device status chart on an overview, and bind View all link to a separate Alarms state with the full alarm table. The overview stays calm, and the detail is one click away.
  • Narrow the alarm filter to the severities your team actually responds to. A card counting warnings that nobody reads makes every other number on it harder to trust.
  • Use one card per site or building, each with its own alias, to compare sites at a glance on a portfolio dashboard.

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.