Alarm-list (Section)#
Path: /alarms/alarm-list
The alarms in the system.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| number-of-alarms | gauge32 | optional | This object shows the total number of alarms in the system, i.e., the total number of entries in the alarm list. | |
| last-changed | date-and-time | optional | A timestamp when the alarm list was last changed. The value can be used by a manager to initiate an alarm resynchronization procedure. |
Subsections#
| Name | Type | Description |
|---|---|---|
| alarm | List | The list of alarms. Each entry in the list holds one alarm for a given alarm type and resource. An alarm can be updated from the underlying resource or by the user. The following leafs are maintained by the resource: ‘is-cleared’, ‘last-change’, ‘perceived-severity’, and ‘alarm-text’. An operator can change ‘operator-state’ and ‘operator-text’. Entries appear in the alarm list the first time an alarm becomes active for a given alarm type and resource. Entries do not get deleted when the alarm is cleared. Clear status is represented as a boolean flag. Alarm entries are removed, i.e., purged, from the list by an explicit purge action. For example, purge all alarms that are cleared and in closed operator state that are older than 24 hours. Purged alarms are removed from the alarm list. If the alarm resource state changes after a purge, the alarm will reappear in the alarm list. Systems may also remove alarms based on locally configured policies; this is out of scope for this module. |