# List of Alarms

The **List of Alarms** widget in BuildingPro Suites offers a compact overview of alarms that have been triggered by specific rules. It allows for a quick overview of all active alarms and provides basic information to enable a timely response to disruptions. Filtering the alarms by tags helps to display only the most relevant alarms.

{% hint style="info" %}
This widget must be created as a [-> Custom Widget ](https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/custom-widgets)and is created with the [-> Alarm](https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/custom-widgets/modules/alarm) module.
{% endhint %}

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2F27gQ0y3ty2WObueBP8Zd%2FAlarm%20detailled%20(4).png?alt=media&#x26;token=35eecdee-5f51-4c63-bd74-da421cc2d6ec" alt=""><figcaption></figcaption></figure></div>

## Widget

The **List of Alarms** widget shows an overview of all active alarms filtered by tags. It contains information about the priority of the alarms, the affected assets, and the date the alarm was triggered. The alarms are displayed in a compact sorted list, which allows for a quick overview of the most important alarm details.

## When should this widget be used?

The **List of Alarms** widget should be used when a quick and compact overview of all active alarms is needed. It is particularly suitable for situations where many alarms need to be monitored at once without going into detail. This widget is ideal for easily keeping track of the status of all alarms and intervening purposefully when necessary.

<div data-full-width="true"><figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FS2zMWJZlQN9ED5C6H4yt%2FAlarm%20detailled%20(3).png?alt=media&#x26;token=28f2b32e-a0b2-49ad-a78d-7f50baa3e9ef" alt=""><figcaption></figcaption></figure></div>

<table data-full-width="true"><thead><tr><th width="65.20001220703125"></th><th width="167"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Primary Asset</td><td>Select the primary asset. This selection determines which title <strong>[A]</strong> appears in the widget.</td></tr><tr><td><strong>[B]</strong></td><td>Width</td><td>Choose how much space the widget should occupy on the dashboard.</td></tr><tr><td><strong>[C]</strong></td><td>Tag Setting</td><td><p>You can filter alarms by specific tags to display only relevant alarm data.</p><ul><li><strong>All selected required</strong>: Only alarms that have all selected tags are displayed.</li><li><strong>One of the selected</strong>: Displays alarms that have at least one of the selected tags.</li></ul></td></tr><tr><td><strong>[D]</strong></td><td>Select Tags</td><td>Select the tags by which the alarms in the widget should be filtered to display only the relevant alarms.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/custom-widgets/list-of-alarms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.