i4connected Knowledgebase

Historical Alarms

Abstract

The list of Historical Alarms covers all the closed and acknowledged Event occurrences providing the user with an advanced filtering mechanism.

This article describes the Historical Alarms concept and functionality from the i4connected portal.

The Historical Alarms functionality of the i4connected portal covers all the historical events (closed alarms and acknowledged alarms) inside the i4connected system.

As opposed to the online Alarming panel, the Historical Alarms panel is not updated live and requires a refresh in order to update the list of historical alarms.

The Historical Alarms are displayed in a dedicated panel accessible from the Admin portal page by clicking the Historical Alarms tile.

Historical_Alarms.jpg

The Historical Alarms tile

Clicking on the Historical Alarms tile the Historical Alarms is opened. This is the main interface where the user can view, filter and manipulate historical alarms.

Historical_Alarms_panel.jpg

The Historical Alarms panel

The Historical Alarms panel displays the open alarms associated to the filtered entities. The historical alarms are available to all users who have access to the source devices. Even so, the Historical Alarms panel is visible only for the users which have the proper roles assigned: Alarm Viewer, Alarm Manager, Admin and Super Admin.

For example, a user who has the Alarm Viewer role will only see the historical alarms from the devices which are assigned to him.

The entity filtering system is shared with other panels inside the i4connected portal, and can be accessed using the top-right Filter button.

Tip

For more details regarding the usage of Object Filters panel please also visit the article here.

The actions bar of the Historical Alarms panel allows the user to perform various actions on one or multiple alarms.

Actions_bar_historical_alarms.jpg

The Actions bar of the Historical Alarms list

In order to activate the top menu buttons, at least one alarm needs to be selected from the alarms table. The selection is done by marking the check-boxes corresponding to the desired alarms.

The following actions can be performed on one or more alarms:

  • Acknowledge - acknowledges the alarm

  • Close - this option is inactive as the alarms in this view already have an end date.

  • Take ownership - assigns the current user as owner of the alarm, if the current user is not the owner of the alarm already

  • Assign ownership - allows the user to assign another user as owner for this alarm. Clicking this button will open the Select Users panel where the owner user can be selected.

  • Prioritise - allows the user to change the priority of the alarms

The Historical Alarms panel also provides an extended set of alarm quick filters, which allow the user to narrow down the list of alarms (already filtered by entities).

Capture836.jpg

The Historical Alarms quick filters

The alarms quick filters are located at the top of the Historical Alarms panel, under the actions menu, and are the following:

  • Search filter - allows the user to filter the open events using a custom text. The panel will display only the events for which the imputed text matches any text filed of the alarm (Event, Metadata, Owner, Source).

    Capture593.jpg
  • Owner filter - allows the user to filter the open events by their owner. The user can select one of the three available options:

    Capture594.jpg
    • All - all events will be displayed, for all owners

    • Assigned to me - only the events for which the current user is the owner will be displayed

    • Not Assigned - all events with no owner assigned will be displayed

  • Acknowledgment filter - allows the user to filter the events based on their acknowledgement status. The user can select one of the three available options:

    Capture595.jpg
    • All - all events will be displayed, regardless of their acknowledgment status

    • Acknowledged - only the acknowledged events will be displayed

    • Not Ack - only the not acknowledged events will be displayed

  • Status filter - allows the user to filter the events based on their status. The options are:

    Capture596.jpg
    • All - all events are displayed

    • Open - only opened events are displayed

    • Closed - only closed events are displayed

  • Priority filter - allows the user to filter the events based on their priority. The priority values can be set as desired.

    Capture597.jpg
  • Type filter - allows the user to filter the events based on their alarm types.

    Capture598.jpg
  • Group filter - allows the user to filter the events based on their alarm group. The filter is structured as a hierarchical tree, where the user can select multiple alarm groups (nodes) from the hierarchical structure. When multiple groups are selected, the events belonging to the any selected group will be displayed altogether, not just the events that belong to all selected groups simultaneously (this filter does not act like an intersection of the selected groups).

    Capture599.jpg
  • Time filter - allows the user to set up a time interval and display all events which are/were active either partially or totally within this defined time interval.

    Capture600.jpg

The alarms are listed in the table available in the main area of the Historical Alarms panel.

list_of_historical_alarms.jpg

The list of Historical Alarms

The historical events table lists the events on 9 columns which show important event details:

  • Priority - the priority of the alarm, stated by the priority number (actual priority value) and the color code of the priority stage

  • Event - the occurrence of the alarm event

  • Metadata - additional information for this specific event occurrence (alarm)

  • Acknowledged - the date of acknowledgement of the alarm. If the alarm is not acknowledged, a live counter will display the time since the alarm has been opened up to the current time.

  • Owner - the user which owns the alarm

  • Source - the device of origin for this occurrence, the source of the problem

  • Start - the date and time when the alarm was opened (the current event has occurred)

  • End - the date and time when the alarm was closed (or the event occurrence was terminated). If the alarm is still open, a live counter will display the time since the alarm has been opened up to the current time.

  • Comment - the alarm comment

  • Status - the state of the alarm, represented by symbols: Open, Acknowledged or Closed.

To see the details of a specific historical alarm, the user can selected from the list view. This action will open the Occurrence panel.

The Occurrence panel of a Historical Alarm

The Occurrence panel displays all the available information about the current alarm (occurrence of the selected event).

Historical_occurrence.jpg

The Historical Event occurrence panel

The panel's header will reflect the alarm status and event as title, as well as the alarm priority reflected in the header's background color. The top menu of the Occurrence panel provides the means to take action on the alarm.

Important

The actions bar will be available only for the users having at least the Alarm Manager role assigned. Users with the Alarm viewer role, cannot perform further actions in this view.

Actions_bar_historical_alarms.jpg

The Historical Event Occurrence actions bar

The following actions are available in this bar:

  • Acknowledge - acknowledges the alarm

  • Close - this option is inactive as the selected event occurrence has been already closed.

  • Take ownership - assigns the current user as owner of the alarm, if the current user is not the owner of the alarm already

  • Assign ownership - allows the user to assign another user as owner for this alarm. Clicking this button will open the Select Users panel, allowing, where the desired user can be searched and selected.

    Assign_Ownership.jpg
  • Prioritize - allows you to assign a priority tho the current alarm occurrence. The Priorities panel lists all available priorities and allows you to define new ones.

    Prioritize.jpg
  • Comment - allows you to add a comment to the current alarm occurrence. The Change comment panel lists all available comments and allows you to edit them.

    Comment.jpg

The Status and Information section of the Occurrence panel, located below the top menu, displays all the available information about the alarm. The data displayed in this area can vary from one Alarm to another.

Information_area.jpg

The Occurrence status and information area

The Context section of the Occurrence panel displays the source of origin for the alarm. This section is located under the Status and Information section. The Event Occurrence Context can be either Logbook (manual events), Device, Server, Adapter or Query.

Capture606.jpg

Example of Occurrence Context

If the Context is a Device the user can open it in detailed view mode, where additional information and actions are available, as described in the Device management article.

Capture607.jpg

The Occurrence Device

The Site section of the Occurrence panel shows the site of origin for the alarm. The user can open the Site in detailed view mode, where additional information and actions are available for it, as described in Sites management article.

Capture1309.jpg

The Occurrence Site

The History section of the Occurrence panel displays all the actions performed on the current alarm, being ownership assignments, acknowledgements, etc. Each action log is represented in real time, along with the date and time of the action and the user who performed the action.

Capture608.jpg

The Occurrence History