Documentation
Alarms
An alarm serves as a task for a user to follow up on problematic events. Alarms are created automatically from an event, if this is configured for the event trigger. Users can take actions in the real world to resolve the cause of the alarm. Once the alarm is no longer active, i.e. the latest event is not problem or warning anymore, it can be closed marking its resolution.
Managing alarms
Alarms are shown in an overview page. From there, you can zoom into individual alarms and manipulate them.
Alarm overview
The alarm overview shows all alarms with some of their details. Alarms can be filtered based on subjects and event triggers.
The status of an alarm describes what stage of its workflow it is in:
Status | Description |
---|---|
Unacked | Short for unacknowledged. The alarm is new and has not been acknowledged by anyone. |
Acked | Short for acknowledged. Someone has acknowledged the alarm and is working on resolving it. |
On hold | The alarm has been picked up, but its handling is held up by some external condition. |
Closed | The handling of the alarm is complete. An alarm that is closed cannot go back to another status anymore. |
Until an alarm is closed, new events for the same subject/trigger combination will not cause alarms to be created. Those events will simply belong to the existing alarm.
An alarm can only be closed if the latest event is no longer a problem or a warning. Once the alarm is closed, new problem/warning events will cause a new alarm to be created.
Based on their status, alarms are grouped into four different buckets:
Bucket | Description |
---|---|
Open | Shows alarms that are unacknowledged or acknowledged |
On hold | Shows alarms that are on hold |
Closed | Shows alarms that are closed |
All | Shows all alarms regardless of their status |
For convenience, some status transitions can be initiated by using buttons in the overview itself.
Alarm details
From the overview page, you can navigate to the details page by clicking on one of the alarms.
Alarms have the following attributes:
Attribute | Description |
---|---|
ID | A number that makes it easy to refer to the alarm. |
Created date | The time that the alarm was created. |
Subject | The subject that the alarm applies to. |
Trigger | The event trigger that caused the alarm to be created. |
Priority | The priority of the alarm: Critical, High, Medium, Low or no priority. |
Status | The stage of the workflow that the alarm is in. |
Description | A user editable description of the alarm. |
The initial priority is determined by the event trigger definition, but it can be changed later on. The status can be changed by using one of the buttons or by clicking the status and using the dropdown.
The events section shows a summary of the events that occurred during the lifetime of the alarm. You can navigate to the events overview to see all the individual events.
At the bottom of the details page, you can find an activity log. Here you see all the changes (change status, update description, etcetera) that were made to the alarm including the person who made the change.
Suppressing alarms
If you do not want alarms to be created for a certain period or for specific subjects and/or event triggers, you can create a suppression. A suppression stops all follow-up actions of an event, including alarm creation. See suppressing events for more information.