i4connected Knowledgebase 5.6

Online Alarms

Abstract

Check out this article to learn more about the Online Alarms panel and the functions that one can organise in this view.

The i4connected portal displays the events in a dedicated panel, which can be accessed using the events icon from the portal's top bar.

No_alarm.jpg

The events icon

The user can quickly see the number of open and unacknowledged events and the highest priority reflected by the number next to the events icon (open and unacknowledged alarms) and the color of the icon (the color of the highest priority of the opened alarms).

Alarms.jpg

Example of display for unacknowledged Events

Clicking on the events icon the Alarms panel is opened. This is the main interface where the user can view, filter and manipulate open and ongoing alarms.

Important

The list of Events is visible only for the users having at least the View events permission enabled. The Events list is further on filtered on basis of other criteria:

  • the currently logged in user can always see Events to which he / she is Owner or Acknowledger;

  • the currently logged in user can only see Events associated with sources with which the user has a relationship;

    Note

    If the Source of the Event is the Server, the user is required to have the View server events permission enabled.

  • the currently logged in user can only see Events of other users if an equal or inferior relationship between the users exists.

Online_alarms_panel.jpg

The Online Alarms panel

The Objects filters panel is shared with other panels inside the i4connected portal, and can be accessed using the top-right filter button. The filter panel allows the user to find the desired entities (Organizational Units, Sites, Areas or Devices). The clicked entities will be added to the selection, and all the open events associated with the selected entities will be displayed in the panel one the user clicks the Apply or Apply & Close buttons.

Tip

For more details regarding the Object filters, please also visit the article The Object Filter.

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

Alarms_filters.jpg

The quick filters bar

  • 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 open events by their owner. The user can select one of the three available options:

    Owner_filter.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 acknowledgment status. The user can select one of the three available options:

    Acknowledge_filer.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_filter.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_filter.jpg
  • Type filter - allows the user to filter the events based on their alarm types.

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

    Filter_by_group.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_filters.jpg

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

List_of_events.jpg

The list of online events

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

  • Acknowledge - 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 origin for this occurrence which can be a Site, an Area, an Organizational Unit, a Device, an Adapter or the i4connected Server.

    Warning

    The list of events also considers the currently logged in user's access permissions to the Event Source. Hence, if the user does not have access to the Event Source, the Event will not be listed in the Online Alarms panel.

  • 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 most recent alarm comment

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

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

Alarms_actions_bar.jpg

The Alarms actions bar

In order to activate the top menu buttons, at least one alarm needs to be selected from the events 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 event. The Acknowledge alarm button is available only for users having the Acknowledge event permission enabled.

    Acknowledge_alarm.jpg
  • Close - Closes an open alarm by adding an end date and manually closing the event. The Close alarm button is available only for users having the Close events permission enabled.

    Close_event.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_ownership.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_ownership.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.

    Change_event_prio.jpg

When the user clicks on an alarm from the events table, the Occurrence panel is opened, presenting more detailed information about the current alarm.

The Occurrence panel

The Occurrence panel displays detailed 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.

Occurences_panel.jpg

The Event occurrence panel

The panel's header will reflect the alarm status and event as title, as well as an alarm priority colored flag.

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

Occurence_actions.jpg

The Occurrence actions bar

  • Acknowledge - acknowledges the alarm.

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

    ack.jpg
  • Close - closes the alarm occurrence.

    The Close alarm button is available 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.

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

    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.

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

By clicking the Extra Information button, the Status and Information section is expanded to provide the user with more data about the current occurrence.

ExtraInfo.jpg

The Extra 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_from_occurrence.jpg

The Occurrence Device

If the Context of the Event occurrence is an Email parser Device, an Email target Device or an Email Adapter, the user can open the Email Alarm scripts panel in order to check the script and manually test its results. For more details about the Email Alarm scripts, please also visit the dedicated article here.

Script_opened_from_Occurrence.jpg

The Occurrence Script

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