Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: published 8.0.11 changes


titleAlarm Journal Profile

To view alarm history, an Alarm Journal Profile and a valid connection to a database must be created first before logging alarms.


The Alarm Journal Table has many built-in properties that allow you to filter on various parts of an alarm in a Perspective Session. It provides a host of built-in filter options that are immediately available and easy to modify to help you get started. You can filter on Realtime and Historical alarm events using the Data Range selector .  The Search Bar  lets you further optimized your search results. You can even organize the alarm data to show or hide columns, reorganize and resize columns, and change the sort order to ascending or descending.

General Filtering

When you use the Alarm Journal Table for the first time in a Perspective Session, you could be using the default journal properties, or your project designer or system administrator may have preconfigured some journal properties specific to your project. Either way, an operator can easily choose and filter the alarm data and how they want it displayed. 

By default, the Alarm Journal Table displays all alarm events for the last 8 hour and displays event alarms that are in an Active, Acknowledged and Cleared state with a priority of Low, Medium, High and Critical. You can easily change these filter options by clicking on the Filter icon  and adding or removing a filter option from the dropdown by checking or unchecking a filter option. Notice that there is a filter bar at the top of the table that also displays all the filter options that are currently set. You can remove any of these filter options by clicking the 'X' on the right side of the option, but to add a filter, use the Select Filter dropdown   Notice how the 'state' filter options show the row color on the tab for Active , Acknowledged  and Cleared .


Scroll html ignore

NameAlarm Journal - General Filtering

Using the Search Bar

You can optimize your filtered results using the Search Bar. Click on the Search icon  and create your own search string to find specific alarms, events, and conditions. 

Filtering on Date Range

The Alarm Journal Table can filter for alarm events in either Realtime or Historical. To filter on Realtime or Historical alarm events, select the Date Range icon 


You can filter on Realtime alarm events using the Data Range feature. Simply enter select Realtime, and enter the amount of time in hours, days, weeks, months, or years of the alarm events to display. Then click Apply.


The Alarm Journal Table displays the complete history of all alarms within a specific time period that you set. Typically, operators want to filter alarm events within a specific time period so they can narrow down the number of alarm events that need to be viewed. Select Historical, enter the date range by clicking on the Start Date and End Date, then select the Start Time and End Time, and click Apply

Viewing and Sorting on Alarm Data

There are a host of configuration settings to choose from in which to display alarm event data. In a Perspective Session, operators can choose to display or hide alarm data in the table by checking or unchecking any of the Configuration Settings  or by right clicking in the header row of the table. It's super easy to filter and display alarm event data using the configuration options provided in the column header of the Alarm Status Table. You can do a multi-column sort by holding down Ctrl + Shift and clicking on the column headers you want to sort by.

If you need to align the columns, simply put your cursor to the left of the column header and drag left or right. There is a 'strictWidth' property for each header column that can be configured in the Designer to strictly enforce the column width.


Sorting Alarm Journal Data

- H2 header

Perspective's Alarm Journal Table now supports multiple sort orders. The order is first determined by the sort order properties on the Alarm Journal Table. The new sort order property is 'activeSortOrder.' Each column that you add to the sort order property will also need to have a sort defined under the columns property as either ascending or descending. 

Image Modified

You also need to make sure the configuration columns you choose for your sort are displayed on your table. In the following image, you can see that the sort order is Event State - Priority - Event Time. Notice how each column is numbered according to the order you defined in your activeSortOrder property.  

Image Modified

Columns will first sort by anything defined in activeSortOrder property and then fallback to the other sorts defined in the columns configuration.

Viewing Alarm Details

If you want to find out more details about an alarm event, simply mouse over an alarm event and click on the popup modal that will appear on the right side of table. This opens an Alarm Detail window that displays the alarm properties and any notes that were entered by an operator. 

Viewing All Instances of an Alarm

If you select an alarm, a window will appear at the bottom of the journal table where you can choose to view instances of that specific alarm or its source path. When you click on the Alarm button, the journal table will refresh with instances of the selected alarm. 

In this example, High Speed alarm was selected to view all instances of the alarm. 

Click the View all events link to return to all alarm events on the journal table.

Viewing the Source Path of an Alarm

You can also click the Source Path button to display the source path of the selected alarm. 

Click the View all events link to return to the alarm events on the journal table.