Overview

Overview of the Alerts Module

The GE Digital APM Alerts module provides alerts from the sensors and analytics running in your facility.

When asset sensors send data to the system, the predictive analytics conduct threshold matching. When the data does not match the parameters set in the system, GE Digital APM generates an alert.

Tip: You need specific permissions to complete these tasks. For more information, refer to the Users and Permissions documentation.
The Alerts Inbox heading displays the name of the filter selected, such as Unclaimed or My Alerts. It also displays the following icons from left to right on the screen:
  • Refresh button (), which can be switched on or off by selecting it.
  • Refresh interval, which can be changed.
  • The Table Grid button (), which, when selected, shows the Alerts inbox as a table.
    Note: When you are in the table view, the button changes to the Inbox View button ().
  • The List button (), which allows you to create an alert, view recurring alerts, or export all alerts to a CSV file.
Alerts are displayed in a queue once the Alerts microapp has opened. The filter My Alerts opens by default. The other default filters can be accessed by selecting the drop-down arrow next to the filter name:
  • My Alerts – Claimed by you.
  • Unclaimed – Not yet assigned or claimed.
  • SmartSignal – Available if SmartSignal is enabled.
    Note: This filter is not available in Predix APM
  • more filters – Can be used to create custom filters.

You can sort the queue by Time Received, Severity, or Alert Name. If you sort the inbox by Time Received, Severity, or Alert Name, the sorting persists when you switch to the Alert Inbox Grid View. Once you have done the initial sort, you can sort by Ascending or Descending.

The Alerts queue refreshes every 30 seconds by default when auto-refresh is enabled, allowing you to view new alerts as they become available. If you manually refresh the queue by selecting the Refresh icon (), the auto-refresh restarts in 30 seconds. Disabling auto-refresh prevents new alerts from loading until you manually refresh the queue. You can change the auto-refresh interval by selecting a different value from the drop-down menu to the right of the Refresh icon:
  • 10 sec
  • 30 sec (default value)
  • 1 min
  • 5 min
  • 10 min
  • 1 hr
  • Off
Note: When you select an interval time to refresh the Alert Inbox view and grid view, your selection persists between both views so you can get the most recent results. Your filter and grid customizations also persist after refreshing.
From the queue, each alert displays the following information when available:
  • Alert name, severity, and the number of latched alerts displayed in parentheses between the severity and alert name. If there are no latched alerts, then nothing displays between the severity and alert name.
  • Incident count for SmartSignal next to the alert name.
  • Date the alert was received.
  • Status of the alert.
  • Asset ID and site name.
  • An icon for a recurring alert ().

An alert selected from the queue provides information about the alert and acts as a repository for notes and evidence pertaining to the issue.

About Alert Details Page

The Alert Details page displays all of the information about a given alert.

The Alert Details page contains the following sections to provide functionality or information about a selected alert.
Note: You will only see the Recommendations and Work History sections in the Alert Details page of the GE Digital APM application.
Alert Header

Contains basic information about the alert:

  • Alert name, severity, and latched alert count – If the alert is latched, the number of grouped alerts appears in parentheses between the severity and alert name. Select to display a tooltip with an alert description. You can change the alert template from this tooltip.
  • Date and time for receipt of the alert.
  • Alert type.
  • Asset Name – Select Asset ID to view the Asset Faceplate.
  • Site name – Select the site name to display a tooltip with customer information.
  • Asset ID.
  • Alert status and disposition.
  • The Limited Visibility Alert icon () – Toggle the icon to change the alert visibility from limited to general. When visibility is set to General, the icon changes to the General Visibility Alert icon ().
  • The Unsubscribed/Subscribed icon – By default, the alert displays a status of Unsubscribed (), but toggling it changes it to Subscribed ().
  • The Timeline View button – when selected, shows a list of actions taken chronologically (with latest action on top) for that alert, instead of the alert sections. Select Section View to revert to the default view of the alert, showing all of the sections.
  • A Claim Alert, Claim Advisory, or Reopen button, based on the status of the alert.
  • Disposition drop-down list for the alert. This list appears when a claimed alert has a Ready or In Process status. If the alert has already been processed, the page displays the previously selected disposition.
  • The Create Case button. This appears when you have claimed an alert and it is in the Ready or In Process state.
  • Actions drop-down menu, where you can release a claim, assign an alert, mark the alert as processed, or navigate to an external link.
ASSET INFORMATION
Lists the name of custom attributes and their values for the asset associated with the alert. If there are no custom attributes available for the asset, the section will not contain any data. Additionally, you can hide the custom attributes for which no value is configured by selecting the Hide empty values check box.

You can export this section to a PDF file. If the Hide empty values is selected, the attributes that do not contain a value are not exported.

ALERT INFORMATION
Includes the Alert ID, Event Time, Alert Source, Alert Owner, and Density (if a SmartSignal alert).
  • Asset Criticality – Select the criticality number to view the Criticality Analysis page that offers details on the justification level of the criticality for the primary asset related to this alert.
    Note: This feature is not available in Legacy Predix APM.
  • The Density value appears only for SmartSignal and SmartSignal Tag Rule alerts. For other Alert types, the value is blank.
  • The latest Density, Last Processed Time, and Last Observed Time values appear only for SmartSignal and SmartSignal Tag Rule alerts. For other Alert types, the value is blank.
  • For latched alerts, the Alert Information changes to Group Information. In addition, instead of Event Time, First Occurrence appears after Alert ID, displaying the date and time of the first occurrence of the latched alerts, and Event Time/Last Occurrence appears next, displaying the date and time of the latest occurrence of the latched alerts.
ANALYSIS
Lists the available analysis views for the alert, and provides a link to the associated alert analysis chart on the Analysis page. Accessing the link opens the template in a new browser tab.
Note: If the alert does not have an Analysis section in the Alert template, then the Analysis section will not appear in the Alert Details page.
For Predix APM, accessing an analysis template link in the Alerts Details page causes the analysis template to be shown in the Meridium tab.
IINTERNAL LINKS
Lists the links to other internal sections, such as Analysis. This section appears in Alert Details only if the associated alert template has the section.
SIMILAR RECORDS
Lists alerts similar to the selected item, work history records, and related cases.
SCAN GROUP DATA
Provides tag names and values for the tags that contributed to the alert.
INTERNAL NOTES
This section only appears if you have either View Internal Notes or Manage Internal Notes permissions. These notes do not appear in the Alert Detail grid view, nor can they be exported via PDF.
NOTES
Use this section to read and add public notes related to the alert. These notes are viewable in the Alert Detail grid view and can be exported via PDF.
EVIDENCE
Use this section to upload images and documents related to the diagnosis of the issue. You also can view saved alert-analysis charts.
RECOMMENDATIONS
Note: This feature is not available in Legacy Predix APM.
You can create a recommendation from the Alert Details page to propose a course of action to fix the problem that the alert has indicated.
New Recommendation creation from an alert – To create a new recommendation, select the Add icon () to open the Record Manager tab, which displays an Alert datasheet that you will need to complete.
To create and view recommendations from the Alert Details page, the following preconditions must be met:
  • The same asset data must be available and mapped in both the GE Digital APM and Meridium systems.
  • The user must have Predix Work Order Management permission to view Recommendations and Work History sections.
The Recommendations section displays the following data created from the selected alert:
  • Recommendation description – Selecting it opens the Recommendation datasheet page in a new tab, which displays the details of the selected recommendation. You can edit the recommendation, if you have the permissions to do so.
  • Recommendation ID
  • Recommendation status
  • Recommendation priority
  • Recommendation Target date
  • Work Request ID created for this recommendation
  • View all Recommendations link – Opens a new tab that displays a list of all of the recommendations available for the given asset. When you select a recommendation name, a new tab opens where you can view the details of that recommendation.
  • Add a Comment link – you can add a comment to the recommendation. Once you save the comment, it displays along with your user name, the date and time that the comment was added.
Note: When there are multiple recommendations for a given alert, the latest created recommendation is displayed first, with the remaining recommendations arranged in descending order based on the recommendation creation date. If no recommendations are shown for a given alert, then the message There are no Recommendations created for this alert appears under the Recommendations heading.
WORK HISTORY
Note: This feature is not available in Legacy Predix APM.
You can view work orders from the Alert Details page to understand the details of the work being done to resolve the issue that the alert has indicated. The following precondition must be met:
  • The same asset data must be available and mapped in both the GE Digital APM and Meridium systems.
Selecting the Work Order description in the Alert Details page opens the Work History datasheet in a new tab, which shows the details of the selected work order.
Provides the Work Description, Work Order number, Status of the order, Work Request number and the Scheduled Date for completion of the work.
Note: The work orders that appear in the Work History section of the Alert Details page are retrieved from the database using the GE_WH_ALERTS query. By default, the GE_WH_ALERTS query is configured to use the Alert ID as its parameter to retrieve the work orders based on the ID of the Alert. However, if you want to work orders to be retrieved from the database based on the Asset or Analytic Template associated with the Alert, you can modify the GE_WH_ALERTS query to use one of the following parameters:
  • Asset ID: To retrieve the work orders based on the unique identifier of the Asset associated with the Alert.
  • Name of the Analytic Template: To retrieve the work orders based on the Analytic Template associated with the Alert.
For more information on modifying the query, refer to the Queries documentation.
View all Work Orders link – Opens a new tab which displays a list of all of the work orders available for the given asset. When you select a work order description, another tab opens where you can view the details of that work order.
Note: The work orders that appear in this datasheet are retrieved from the database using the GE_WH_ALERTS query. By default, the GE_WH_ALERTS query is configured to use the unique identifier of the Asset associated with the Alert as its parameter to retrieve the work orders based on the Asset ID. However, if you want to work orders to be retrieved from the database based on the Alert ID or Analytic Template associated with the Alert, you can modify the GE_WH_ALERTS query to use one of the following parameters:
  • Alert ID: To retrieve the work orders based on the unique identifier of the Alert.
  • Name of the Analytic Template: To retrieve the work orders based on the Analytic Template associated with the Alert.
LINKED CASES
Displays a list of cases created by the alert.

About Alert Severity and Status

Alert Severity

Each alert displays a colored box containing a number, both of which reflect the severity of the alert.

Table 1. Alert Icon Colors and Corresponding Severity Levels
ColorSeverity level
Dark Red1
Red2
Orange3
Pale Orange4
Yellow5

SmartSignal advisories display an incident-event count in parentheses to the left of the alert name.

Alert Status

The following table shows possible alert status:

Table 2. Possible Alert Status
StatusDescription
ReadyAlert is ready to be claimed.
In ProcessAlert has an owner.
ProcessedAlert has been marked as processed.
In Process EscalatedAlert has been escalated.
In Process MaintenanceAnalytic associated with the alert is in maintenance.

About Alert Timeline View

The timeline view of an alert shows the history of the alert, letting you know who made changes to the alert and when the changes were made.

The timeline view of an alert displays the following events and the user who performed them:
  • When an alert was created.
  • When the alert is claimed.
  • When the alert state is changed, for example, Marked as Processed, or Reopened Alert.
  • When the alert template is changed.
  • When a Note is added to or deleted from the alert. In the Timeline view, you can select the horizontal arrow () to the left of the Note to view the contents of the note.
  • When the alert disposition is changed, for example, Valid or False.
  • When evidence is added to or deleted from an alert.
  • When a case is created from the alert, and who created the case.
  • When an alert is linked to or unlinked from a case.
  • When the visible state of an alert is changed.

To return to the section view, in the details page of the alert, select the Section View button.

Note: To access the Timeline View, you must have Manage Alert permissions or View Alerts and View Notes permissions. However, if you have View Alerts permission but not View Notes permission, then you will not be able to view the timeline.

About Alert Visibility

The limited visibility alert icon is present in the Alert Details page, and is grayed out by default.

All new alerts are designated as "Limited Visibility Alerts" by default. If any asset for which you have permissions has its alerts specified as "Limited Visibility", then you have limited visibility permissions for that asset. If you have permissions to view limited visibility alerts, then, when you are logged in to GE Digital APM, you will see both limited visibility alerts and general visibility alerts.

When you hover over the grayed-out icon, a "Set Visibility to General" message appears. If you have limited visibility permissions for Alerts and permissions to manage alerts, then you can change the visibility factor for an alert by selecting the limited visibility alert icon (), which changes the alert icon to (), meaning that the alert now has general visibility and can be seen by anyone with permissions to view alerts. When you hover over the general visibility icon, a "Set Visibility to Limited" message appears. Selecting the icon returns the visibility of the alert back to limited visibility.

If you have access to the Alert Timeline View, then when an alert is set as "Visible to All", in the timeline view you can see who changed the visibility for the alert and when the change was made. Likewise, when the alert visibility is changed to "Limited", in the timeline view you can see that the visibility was changed to "Limited" as well as who changed the visibility and the time stamp for the change.

About Alert Notification

When an alert to which you have subscribed is updated by another user, you will receive an email notification about the change.

An email will be sent to the email address that you provide in your user profile. When you claim an alert, you are automatically subscribed to that alert. However, you cannot see who else has subscribed to that alert.
Note:
  • When a user updates an alert that belongs to another tenant, you will not receive any email notification about the change even though you have subscribed to the alert.
  • When you lose access to an asset, you lose subscription to the alerts for that asset to which you had previously subscribed.
The following table provides a list of activities that will send an email notification and the email message details. All notifications include the following information:
  • The date and time when the action was performed
    Note: In the email notification, the date and time appear based on the time zone set in the My Preferences page.
  • The first name and last name of the user who performed the activity
An email notification is not sent for the following types of alerts:
  • Alerts whose template property is set to not Consumable.
  • Manually created recurring alerts.
Table 3. Alerts Notification
Activity (that Triggers Notification)Email Notification Details
Alert Assigned<Alert severity and alert ID>

Alert Event Time: <Time at which the event that triggered the alert occurred>

Alert Received Time: <Time of receiving the alert>

Alert Assigned for <Asset ID>: <Asset Name>: <Site Name>

Alert assigned to <User First Name> <User Last Name>

Note: The asset and site details are included in the email only if email notifications are not configured to be secured for the tenant.
Alert ClaimedNo additional detail
Alert Template UpdatedAlert Template updated from <original alert template name> to <current alert template name>
Disposition UpdatedDisposition updated from <Original Value> to <Current Value>
Case CreatedCase <Case ID>: <Case Name> created
Claim ReleasedNo additional detail
Marked as ProcessedNo additional detail
Alert Marked as Processed by Auto CloseAlert <Alert ID>:<Alert Name> Template

Mark as Processed by AutoClose Action in Case

<Date with Timestamp> - <Username>

Alert ReopenedNo additional detail
Note AddedNote Text: <Note Details>
Note DeletedNote Text: <Note Details>
Attachment AddedAttachment Name: <Name of Attachment>
Attachment DeletedAttachment Name: <Name of Attachment>

About Alert Subscription

Subscribing to an alert causes you to be notified when there are any changes to the alert.

You can subscribe to an alert by selecting the grayed-out Unsubscribed icon () in the Alert Details page. Hovering over the icon displays the text "Subscribe to this alert". Once you are subscribed, the icon changes to the Subscribed icon (), which means that you will receive email notifications for changes to that alert. Hovering over the Subscribed icon displays the text "Unsubscribe from this alert". Selecting the icon again will unsubscribe you from the alert.

Whenever you claim an alert, you are automatically subscribed to that alert, and will receive email notification when subsequent changes are made to the alert. The notification will also indicate by whom the changes were made.

Note:
  • When you lose access to an asset, then you lose subscription to the alerts for that asset if you had previously subscribed to alerts for that asset.
  • When you release an alert, you automatically lose subscription to that alert.

About Alert Escalation and De-escalation

Escalation and de-escalation of an alert indicates the significance of the alert, which helps you prioritize the alert for processing. Alert escalation and de-escalation are applicable only to latched alerts, and the status of an alert changes based on the change in severity.

The following table describes the alert escalation and de-escalation indicators based on the severity change.

Change in Alert SeverityEscalation Status Indicator
No change in severityNo change
Increase in severityEscalated
Decrease in severityDe-escalated

Example of Alert Escalation and De-escalation for an Unclaimed Alert in the Ready State

The following diagram illustrates an example of the alert escalation and de-escalation based on the change in severity for an unclaimed alert, which is in the Ready state.



Consider a scenario where an alert occurs four times for the same asset with different severity.

The first occurrence of an alert is the initial alert for an asset. The alert is in the Ready state.

If the second occurrence of the alert for the asset has a severity higher than the initial alert, the initial alert displays with its name to indicate that the alert is escalated.

If the third occurrence of the alert for the asset has the same severity as the severity of the alert in second occurrence, the initial alert displays with its name to indicate that there is no change in severity.

If the fourth occurrence of the alert for the asset has the severity lower than the severity of the alert in third occurrence, the initial alert displays with its name to indicate that the alert is de-escalated.

Example of Alert Escalation and De-escalation for Claimed Alert that is in In Process State

The following diagram illustrates an example of the alert escalation and de-escalation based on the change in severity for a claimed alert, which is in the In Process state.



The first occurrence of an alert is the initial alert for an asset. When you claim the alert, the state changes from Ready to In Process.

If the second occurrence of the alert for the asset has a severity higher than the initial alert, the following changes occur on the initial alert:
  • The state of the initial alert changes to In Process Escalated.
  • The initial alert displays with its name to indicate that the alert is escalated.
If the third occurrence of the alert for the asset has the same severity as the severity of the alert in second occurrence, the following changes occur on the initial alert:
  • The state of the initial alert will remain as In Process Escalated.
  • The initial alert displays with its name to indicate that there is no change in severity.
If the fourth occurrence of the alert for the asset has the severity lower than the severity of the alert in third occurrence, the following changes occur on the initial alert:
  • The state of the initial alert changes to In Process.
  • The initial alert displays with its name to indicate that the alert is de-escalated.

About SmartSignal Analytic Instance for Maintenance

Performing maintenance is the process of selecting an analytic instance associated with a SmartSignal alert for maintenance and retraining the analytic instance. You can select the SmartSignal analytic instance from the Alerts application independent of the SmartSignal application.

Note: You can perform maintenance of analytic instances for only SmartSignal alerts that are in the In Process state. The SmartSignal alerts should belong to the same tenant.

When you select Perform Maintenance for an alert, the status of the alert changes to In Process Maintenance, which signifies that the alert was generated because the analytic instance did not accurately reflect the current operating state. Therefore, you can select the analytic instance associated with the alert for maintenance and retrain the analytic instance.

Note:
You must have the following permissions to perform maintenance:
  • The Alerts or Manage Alerts permission to change the status of the alert to In Process Maintenance.
    Note: You can change the status of an alert other than a SmartSignal alert to In Process Maintenance. However, you cannot access the analytic instance for the alert.
  • The SmartSignal Mapping permission to modify an analytic instance of a SmartSignal alert. For more information on SmartSignal permissions, refer to Default Permission Set Definitions in the Users and Permissions documentation.