i4connected Knowledgebase 5.6

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 the following historical alarms:

  • Acknowledged alarms

  • Closed alarms

  • Audit events

    • Login / Logout actions

    • Change password actions

    • Add / Edit / Delete user actions

    • Change user password actions

    • Change role assignments actions

    • Any CRUD operation performed in the system

Important

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.

The list of Historical Alarms is guarded by the View events permission. Further on, the currently logged in user can only see audit events implying own user changes. In order to view the audit events related to all portal users, the View audit log permission is also required.

The Historical Alarms panel is main interface where the user can view, filter and manipulate historical alarms.

Historical_alarms.jpg

The Historical Alarms panel

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 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).

Historical_alarms_filters.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).

    Simple_search.jpg
  • Owner filter - allows the user to filter the list of historical alarms by their owner. The user can select one of the three available options:

    Owner_search.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

  • Audit filter - allows the user to filter the list of historical alarms on basis of audit eents criteria. The user can select one of the three available options:

    Audit_filters.jpg
    • All - all events will be displayed, regardless if they are of type audit or not.

    • Audits - only the events of type audit will be displayed.

    • No audits - all the events will be displayed, except the events of type audit.

    Tip

    For more details about Audit events please also visit the dedicated article here.

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

    Acvk_search.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:

    Status_search.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.

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

    Type_search.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).

    Group_search.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.

    Time_search.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).

  • Comment - the alarm comment

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

The actions bar of the Historical Alarms panel allows the user to perform various actions on one or multiple alarms, based on the assigned permissions set.

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.

Historical_alarms_actions.jpg

The Actions bar of the Historical Alarms list

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

  • Acknowledge - acknowledges the event. The Acknowledge alarm button is available only for users having the Acknowledge event permission enabled.

    Ack.jpg
  • Close - as all the alarms listed in this view are already closed, the Close button is inactive.

    Close_inactive.jpg
  • Take ownership - assigns the current user as owner of the event, if the current user is not the owner of the event already. The Take ownership button is available only for users having the Take event ownership permission enabled.

    Take_own.jpg
  • Assign ownership - allows the user to assign another user as owner for this event. Clicking this button will open the Select Users panel, allowing, where the desired user can be searched and selected. The Assign ownership button is available only for users having the Assign event ownership and View users permissions enabled.

    Assign_own.jpg
  • Prioritize - allows the user to change the priority of the alarms. The Prioritize button is available only for users having the Change event priority permission enabled.

    Prio.jpg

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 Historical Alarm Occurrences panel

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

Depending on the user's permissions set some of the actions and information in this panel may be displayed or not.

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.

Users having additional permissions enabled are provided with a set of actions, as follows:

Oc_actions.jpg

The Historical Event Occurrence actions bar

  • Acknowledge - acknowledges the alarm.

    The Acknowledge alarm button is available only for users having the Acknowledge event permission enabled.

    Ack_closed_event.jpg
  • Close - as the alarm is already in status closed, this button will be inactive. The Close alarm button is visible only for users having the Close events permission enabled.

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

    The Take ownership button is available only for users having the Take event ownership permission enabled.

    Take_own.jpg
  • 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.

    The Assign ownership button is available only for users having the Assign event ownership and View users permissions enabled.

    Assign_own.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.

    The Prioritize button is available only for users having the Change event priority permission enabled.

    Set_prio.jpg
  • Change Comment - allows you to change the current comment of the alarm occurrence. The Change comment panel displays the latest available comment and allows you to edit it. The Comment button is available only for users having the Comment events permission enabled.

    add_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.

Additionally, an Alarm comment can only be viewed by a user having the View events comments permission enabled.

Info_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.

Device_context.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.

Open_device.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.

Open_site.jpg

The Occurrence Site

The History section of the Occurrence panel displays all the actions performed on the current alarm, being ownership assignments, acknowledgments, 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.

history.jpg

The Occurrence History