> For the complete documentation index, see [llms.txt](https://docs.buildings.ability.abb/collection/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/alarm.md).

# Alarm

The "Alarm" widget allows you to monitor a single asset for alarms.

<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%2Fr8pmTc8FYB5hBaJHeNmP%2FAlarm%20List%20Widget.png?alt=media&#x26;token=a4770668-5f40-452b-8a40-2d2dcd588024" alt=""><figcaption></figcaption></figure></div>

<figure><img src="https://3489494878-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9GvUpaatBiReR43XFSMg%2Fuploads%2FfVggu76ymT5cASQR2jUC%2FBildschirmfoto%202023-09-26%20um%2016.54.37.png?alt=media&#x26;token=7d8dfac7-120b-4fa1-ae10-844021ace312" alt=""><figcaption><p>A dashboard with 4 alarm widgets.<br>From left to right: High priority, medium priority, low priority, no alarm present.</p></figcaption></figure>

## When should this widget be used?

This widget should be used when you want to monitor a single asset for alarms.

{% hint style="info" %}
If you want to get an overview of all active alarms, use the widget [-> Alarm Overview](/collection/platform/live-cockpit/widgets/predefined-widgets/alarm-overview.md)
{% endhint %}

## Overview

<figure><img src="/files/gKDK1tZgrtgAC1t7h888" alt=""><figcaption></figcaption></figure>

<table data-full-width="true"><thead><tr><th width="71.33333333333331"></th><th width="231"></th><th></th></tr></thead><tbody><tr><td><strong>[A]</strong></td><td>Header with status display</td><td>Shows the alarm status.<br>In the current image, an alarm with high priority is displayed.</td></tr><tr><td><strong>[B]</strong></td><td>More options</td><td>Shows more options.</td></tr><tr><td><strong>[B]</strong></td><td>Alarm List</td><td>Here, the alarms of the asset are displayed in a list.</td></tr></tbody></table>

## Configure Alarm Widget

<figure><img src="/files/S981jk5E6GsHdTbG7am0" alt=""><figcaption></figcaption></figure>

The Alarm widget displays a tabular overview of all alarms for one or more selected assets.

To configure the widget:

1. Select the **Primary Asset** \[A]

   ◈ This asset is displayed in the widget's title. The selection is optional.
2. Add the desired **Alarm Asset** \[B]

   ◈ Alarms from this asset are displayed in the widget.

   ◈ Multiple assets are possible.
3. Select the **size of the widget** \[C]

   ◈ You can choose between *1 Cell*, *2 Cells*, or *Full Width*.
4. Select the **columns of the alarm list** to be displayed \[D]

   ◈ Activate or deactivate individual columns with a check mark \[D1].

   ◈ The display order of the columns can be changed via drag & drop \[D2].
5. Click **Save** \[E] to apply the configuration

   ◈ The widget now appears in the dashboard with the selected display.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.buildings.ability.abb/collection/platform/live-cockpit/widgets/predefined-widgets/alarm.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.