Reference

AMS Analytics System Requirements

License Requirements

The AMS Analytics license is required to take advantage of the AMS Analytics functionality.

Additional Components Required

In addition to the basic GE Digital APM system architecture, your system must also contain the following additional components:

AMS Intelligent Device Manager V13, which is a third-party component and exceeds the scope of this documentation

System Architecture

The following image shows how the additional components should be incorporated into the basic GE Digital APM system architecture to support this module.

Deploying AMS Analytics

After you have installed and configured the basic GE Digital APM system architecture, you will need to perform some configuration steps specifically for AMS Analytics.

Supported Features in APM Now

This GE Digital APM is not available in the APM Now environment.

AMS Analytics Data Model

The following diagram shows how the families used by AMS Analytics are related to one another.

Note: In the diagram, boxes represent entity families and arrows represent relationship families that are configured in the baseline database. You can determine the direction of the each relationship definition from the direction of the arrow head: the box from which the arrow originates is the predecessor, and the box to which the arrow head points is the successor.

AMS Analytics leverages the fundamental GE Digital APM entity and relationship family infrastructure for storing data that you transfer from an AMS Analytics data source to the GE Digital APM database. AMS Asset Data Source records are used to store connection information that the GE Digital APM system uses to access an AMS Analytics data source and then create records that correspond to the records that exist in the AMS Analytics data source. When data is transferred to the GE Digital APM database from an AMS Analytics data source, one or more records in the following families will be created, depending up on the data that exist in the AMS Analytics data source:

AMS Asset
AMS Asset Alert
AMS Asset Event
AMS Asset Folder

Each record that is created stores the values that exist in the corresponding entities in the AMS Analytics data source. This documentation assumes that you are familiar with the data that is stored in the AMS Analytics data sources. When the records are created, appropriate links are also added between AMS Asset records and the related AMS Asset Alert, AMS Asset Event, and AMS Asset Folder records.

In addition to the families described above, the following families are also used within AMS Analytics:

Equipment and Functional Location: Records that represent the equipment and locations in your facility. Each of these records must be linked to its corresponding AMS Asset record.

Note: If you are not using Equipment and Functional Location records and you want to view AMS Asset Folders and AMS Assets in a hierarchy, you can modify theapplication-wide sset Hierarchy configuration to include the AMS Asset Folder and AMS Asset families.
AMS Asset Recommendation : After transferring data to GE Digital APM, you can create AMS Asset Recommendation records to store information about recommendations for actions that should be taken based upon the transferred data. As with any performance recommendation, you can also create a work request in a configured EAM system when the recommendation is saved.

AMS Analytics Security Groups and Roles

The following table lists the baseline Security Groups available for users within this module, as well as the baseline Roles to which those Security Groups are assigned.

Important: Assigning a Security User to a Role grants that user the privileges associated with all of the Security Groups that are assigned to that Role. To avoid granting a Security User unintended privileges, before assigning a Security User to a Role, be sure to review all of the privileges associated with the Security Groups assigned to that Role. Also, be aware that additional Roles, as well as Security Groups assigned to existing Roles, can be added via Security Manager.


Security Group	Roles
MI AMS Suite APM Administrator	MI Health Admin
MI AMS Suite APM Power User	MI Health Power
MI AMS Suite APM User	MI Health User
MI AMS Asset Portal Viewer	MI APM Viewer

Note: The Security Groups listed in the table above account only for family permissions. Users must also be added to the MI Configuration Role Security Group in order to access the Systems and Tags page, which is required to modify families used by this module.

The baseline family-level privileges that exist for these Security Groups are summarized in the following table.


Family	MI AMS Suite APM Administrator	MI AMS Suite APM Power User	MI AMS Suite APM User	MI AMS Asset Portal Viewer
Entity Families
AMS Asset Alert	View, Update, Insert, Delete	View, Update, Insert, Delete	View, Update, Insert, Delete	View
AMS Asset Event	View, Update, Insert, Delete	View, Update, Insert, Delete	View, Update, Insert, Delete	View
AMS Asset Recommendation	View, Update, Insert, Delete	View, Update, Insert	View, Update, Insert	View
Equipment	View, Update, Insert, Delete	View, Update, Insert	View	View
Functional Location	View, Update, Insert, Delete	View, Update, Insert	View	View
Tag	View, Update, Insert, Delete	View, Update	View	View
Tag Alert	View, Update, Insert, Delete	View, Update	View	View
Tag Data Source	View, Update, Insert, Delete	View	View	View
Tag Event	View, Update, Insert, Delete	View, Update	View	View
Tag Folder	View, Update, Insert, Delete	View, Update, Insert	View	View
Relationship Families
Equipment Has Equipment	View, Update, Insert, Delete	View, Update, Insert	View	View
Functional Location Has Equipment	View, Update, Insert, Delete	View, Update, Insert	View	View
Functional Location Has Functional Location	View, Update, Insert, Delete	View, Update, Insert	View	View
Has Consolidated Events	View, Update, Insert, Delete	View, Update, Insert, Delete	View, Update, Insert, Delete	View
Has Recommendations	View, Update, Insert, Delete	View, Update, Insert	View, Update, Insert	View
Has Tag	View, Update, Insert, Delete	View, Update, Insert	View	View
Has Tag Alert	View, Update, Insert, Delete	View, Update, Insert	View	View
Has Tag Data Source	View, Update, Insert, Delete	View, Update, Insert	View	View
Has Tag Event	View, Update, Insert, Delete	View, Update, Insert	View	View
Tag Folder Has Tag Folder	View, Update, Insert, Delete	View, Update, Insert	View	View

About Site Filtering in AMS Analytics

In AMS Analytics, users will see only data related to AMS Assets assigned to their site(s) or that are global records.

Tip: For more information, refer to the Site Filtering section of the documentation.

Example

Consider an organization that has three sites, Site X, Site Y, and Site Z. The following AMS Asset records exist:

AMS Asset 1: Assigned to Site X
AMS Asset 2: Assigned to Site Y
AMS Asset 3: Assigned to Site Z
AMS Asset 4: No site assigned (global record)

Each of these AMS Assets has related AMS Asset Alerts and AMS Asset Events.

Scenario 1: User assigned to only Site X

When this user views the AMS Analytics Overview page, he or she can view AMS Asset 1 and AMS Asset 4, as well as any associated alerts and events. AMS Asset 2 and 3, and their related alerts and events, are not visible.

Scenario 2: User assigned to both Site X and Site Y

When this user views the AMS Analytics Overview page, he or she can view AMS Asset 1, 2, and 4, as well as any associated alerts and events. AMS Asset 3, and its related alerts and events, is not visible.

Scenario 3: Super User

When this user views the AMS Analytics Overview page, he or she can view AMS Asset 1, 2, 3, and 4, as well as any associated alerts and events.

About Site Filtering in AMS Asset Data Sources

The AMS Asset Data Source family employs the GE Digital APM Site Filter Control. When an AMS Asset Data Source record is initially created, it is assigned as Global. If the record is not reassigned to a specific site, the user will always see the global record.

Tip: For more information, refer to the Site Filtering section of the documentation.

Note: Only a Super User can modify the site assigned to an AMS Asset Data Source record.

The AMS Asset Data Source record is used to facilitate the transfer of records from your Emerson AMS system into GE Digital APM. Specifically, AMS Asset records (Tags) and AMS health records (that is, AMS Alerts, AMS Events, etc.) are transferred into GE Digital APM. AMS Asset records associated with the data source are assigned to Global when they are initially transferred into GE Digital APM.

As recommend, each AMS Asset record record should be linked to an Equipment or Functional Location record. Once an AMS Asset record is linked to an Equipment or Functional Location record, it will inherit the site assignment of the Equipment or Functional Location record. Therefore, if an AMS Asset is linked to an Equipment or Functional Location record assigned to a different site then the AMS Asset Data Source record, then the AMS Asset record can have a different site assignment then the AMS Asset Data Source record to which it is associated. In other words, the site assigned to the Equipment or Functional Location record takes precedent over the site assigned to the AMS Asset Data Source record.

Important: When linking an AMS Asset record, the record can be linked only to Equipment and Functional Locations records assigned to a site to which a user has permissions. For instance, if a user has access to Site X only, then only Equipment and Functional Locations from Site X, and Global records, are available to the user for linking.

Additionally, all linked AMS health records will inherit the site assignment of the linked Equipment or Functional Location record. However, only new health indicator records associated with the AMS Asset Data Source record will be assigned the site from the linked Equipment or Functional Location record. Data already committed to the GE Digital APM Database will not be updated.

Consider an organization that has three sites, Site X, Site Y, Site Z. The following AMS Asset Data Source records exist:

AMS Data Source 1: Assigned to Site X
AMS Data Source 2: Assigned to Site Y
AMS Data Source 3: Assigned to Site Z
AMS Data Source 4: Assigned as Global

Scenario 1: User assigned to only Site X

When this user accesses the AMS Asset Data Sources page, he or she will see only AMS Data Source 1 and AMS Data Source 4. While he or she is able to view AMS Asset Data Source records with site assignment X, the user will not be permitted to modify or change the site assignment.

In addition, the user will be able to access any AMS Asset records from AMS Asset Data Source records 2 and 3 that are yet to be linked to an Equipment or Functional Location record, because all AMS Asset records are transferred into GE Digital APM as Global records.

Finally, the user will only be allowed to link AMS Asset records to Equipment and Functional Location that are assigned to Site X or that are assigned as Global.

Scenario 2: User assigned to both Site X and Site Y.

When this user accesses the AMS Asset Data Source page, he or she will only see AMS Data Sources 1, 2, and 4. While he or she is able to view AMS Asset Data Source records with site assignment X and Y, the user will not be permitted to modify the site assignment of the AMS Data Source.

In addition, the user will be able to access any AMS Asset records from AMS Data Source 3 that have yet to be linked to an Equipment or Functional Location record, because all AMS Asset records are transferred into GE Digital APM as Global records.

Finally, the user will only be allowed to link AMS Asset records to Equipment and Functional Location that are assigned to Site X, Site Y, or that are assigned as Global.

Scenario 3: Super User

When this super user accesses the AMS Asset Data Source page, he or she will see all AMS Data Source 1, 2, 3, and 4. In addition to accessing the data source records, the super user has privileges to reassign the AMS Asset Data Source record to a different site.

If linking AMS Asset records to Equipment and Functional Locations, the super user can link tags and assets from all sites (Site X, Site Y, Site Z, and Global records).

AMS Asset Data Source Records

AMS Asset Data Source records store connection information about AMS Data Sources that GE Digital APM uses to pull data into GE Digital APM. This topic provides a list and description of the fields that exist for the AMS Asset Data Source family and appear in the sections on the AMS Data Source Configuration: New Data Source datasheet.

This family is enabled for site filtering, which means that records in this family can be assigned to a specific site, and will then only be accessible to users who are assigned to the same site and have the appropriate license and family privileges. For more information, refer to the Site Filtering section of the documentation.

Web Service Details

The Web Service Details section of the AMS Data Source Configuration: New Data Source data sheet stores connection information about the web services that the GE Digital APM uses to connect to the AMS Analytics data source.

This section provides an alphabetical list and description of the fields that exist in the Web Service Details AMS Data Source Configuration: New Data Source section and appear on the AMS Data Source Configuration: New Data Source datasheet. The information in the table reflects the baseline state and behavior of these fields.


Field	Data Type	Description	Behavior and Usage
CMMS Data Source	Boolean	This field is no longer used.	N/A
Enabled	Boolean	Enable connection to the web service.	The value in this field determines whether or not GE Digital APM will attempt to retrieve data from this AMS Analytics data source when the scheduled item is executed. When the AMS Asset Data Source record is created, the Enabled check box is selected by default, indicating that the connection is enabled. You can clear the Enabled check box to disable the data source connection.
Name	Character	Name of the AMS Analytics data source to identify the record.	This field is required and must be unique. If you try to save the record with the same value in the Name field as an existing AMS Asset Data Source record, a message appears, indicating that the name is not valid.
Network Domain	Character	The name of the network domain associated with the AMS Analytics data source used to access the web service.	This field is required only if you must first log in to a network to access the web service for the AMS Analytics data source. The GE Digital APM system will use this information only if the Use Network Credentials? check box is selected.
Network Password	Character	The password for the User ID used to access the network.	This field is disabled. To modify this field, click the button to the right of the field, and on theEnter AMS Asset Data Source Password dialog box, type the password and then click OK. This field is required only if you must first log in to a network to access the web service. The GE Digital APM system will use this information only if the Use Network Credentials? check box is selected.
Network User ID	Character	The User ID used to access the network.	This field is required only if you must first log in to a network to access the web service for the AMS Analytics data source. The GE Digital APM system will use this information only if the Use Network Credentials? check box is selected.
Password	Character	The password for the User ID used to access the AMS Analytics data source. Log in to the data source at the location specified in the URL text box.	This field is disabled. To modify this field, click the button to the right of the field, and on theEnter AMS Asset Data Source Password dialog box, type the password and then click OK.
Proxy Port	Numeric	The port number of the proxy server.	This field is required if a port number is associated with the proxy server. The GE Digital APM system will use this information only if the Use Proxy? check box is selected.
Proxy URL	Character	The URL to the proxy server to access the web service.	This field is required only if you must first access a proxy server to access the web service for the AMS Analytics data source. The GE Digital APM system will use this information only if the Use Proxy? check box is selected.
Queue Server	Character	The APM server configured for message queues.	If Message Queuing is enabled, this field is required and must be in the following format: FormatName:Direct=OS:<server>\private$ where <server> is the name of the GE Digital APM server.
Queue Timeout	Numeric	The amount of time in seconds before the connection between AMS Data source and GE Digital APM times out if no responses are received.	After the time limit is reach and error is generated, and the connection to the message queue is closed.
Request Queue	Character	The name of request queue on the GE Digital APM Server.	None
Response Queue-	Character	The name of the response queue on the GE Digital APM server.	None
URL	Character	The URL for accessing the web service associated with the AMS Analytics data source.	This field is required. After you type a URL in this field and navigate to a different field, parameters on the Detailed Report Details tab are populated automatically based upon the AMS Analytics data source that you specify in the URL. Not all the fields on this tab are populated for all AMS Analytics data sources. For more information, see the description of the Detailed Report Details tab.
User ID	Character	The User ID used to access the AMS Analytics data source. Log in to the data source at the location specified in the URL text box.	This field is required.
Use Massage Queuing	Boolean	Enables message queues when collecting data from the AMS data source.	None
Use Network Credentials?	Boolean	Enable network connection information.	Select this check box to indicate that the GE Digital APM system should use the network connection information when accessing the web service.
Use Proxy?	Boolean	Enable proxy connection information.	The value in this field indicates that GE Digital APM should use proxy connection information when accessing the web service.

Detailed Report Details

The Detailed Report Details section of the AMS Data Source Configuration: New Data Source datasheet store connection information that GE Digital APM uses to obtain data from an AMS Analytics data source including:

The contents of the Detailed Reports for that data source.
The file used to convert the external data into the format that SQL Server Reporting Services can use to display the information in the report.

This section provides an alphabetical list and description of the fields that exist for the Detailed Report Details section and appear on the AMS Data Source Configuration: New Data Source datasheet. The information in the table reflects the baseline state and behavior of these fields.

Note: All the fields on the Detailed Report Details record are populated automatically when you enter and save a valid URL in the URL text box on the Web Service Details record.


Field	Data Type	Description	Behavior and Usage
AMS Asset Alert Detail Report Path	Character	The GE Digital APM Catalog path \\Public\Meridium APM\Modules\AMS Asset Portal\Detailed Reports\<Data Source Name>, where <Data Source Name> is the name of the Catalog folder where the Alert Details Report is stored.	Locate the associated Alert Details Report for the desired AMS Analytics data source.
AMS Asset Alert XSL Path	Character	The URL http:// <Application Server Name>/DetailReportService/XSL/<Data Source Name>/GetAlertDetails.xsl, where <Application Server Name> is the name of the GE Digital APM Application server and <Data Source Name> is the name of the folder where the file GetAlertDetails.xsl is stored.	Transform the data from the AMS Analytics data source into the format required to display the report in GE Digital APM.
AMS Asset Detail Report Path	Character	The GE Digital APM Catalog path \\Public\Meridium APM\Modules\AMS Asset Portal\Detailed Reports\<Data source Name>, where <Data Source Name> is the name of the Catalog folder where the Asset Details Report is stored.	Locate the associated Asset Details Report for the desired AMS Analytics data source.
AMS Asset Detailed Report Web Service URL	Character	The URL http://<Application Server Name>/DetailReportService/DetailReporting.asmx, where <Application Server Name> is the name of the GE Digital APM Application server where the file DetailReporting.asmx is stored.	Connect to the data source specified on the Web Service Details tab and obtain the required content from the data source.
AMS Asset Event Detail Report Path	Character	The GE Digital APM Catalog path \\Public\Meridium APM\Modules\AMS Asset Portal\Detailed Reports\<Data Source Name>, where <Data Source Name> is the name of the Catalog folder where the Event Details Report is stored.	Locate the associated Event Details Report for the desired AMS Analytics data source.
AMS Asset Event XSL Path	Character	The URL http://<Application Server Name>/DetailReportService/XSL/<Data Source Name>/GetEventDetails.xsl, where <Application Server Name> is the name of the GE Digital APM Application server and <Data Source Name> is the name of the folder where the file GetEventDetails.xsl is stored.	Transform the data from the AMS Analytics data source into the format required to display the report in GE Digital APM.
AMS Asset XSL Path	Character	The URL http://<Application Server Name>/DetailReportService/XSL/<Data Source Name>/GetAssetDetails.xsl, where <Application Server Name> is the name of the GE Digital APM Application server and <Data Source Name> is the name of the folder where the file GetAssetDetails.xsl is stored.	Transform the data from the AMS Analytics data source into the format required to display the report in GE Digital APM.

Scheduling Settings

The Scheduling Settings section of the AMS Data Source Configuration: New Data Source datasheet stores information about:

How often data is collected for a family.
Which AMS Asset Event records should be collected, based on how far back in time the associated events occurred.

This topic provides an alphabetical list and description of the fields that exist in the Scheduling Settings section and appear on the A AMS Data Source Configuration: New Data Source datasheet. The information in the table reflects the baseline state and behavior of these fields.


Field	Data Type	Description	Behavior and Usage
AMS Asset Schedule	Character	Specifies how often data should be collected from the specified AMS Analytics data source to create and update records in the AMS Asset family.	None
AMS Asset Alert Schedule	Character	Specifies how often data should be collected from the specified AMS Analytics data source to create and update records in the AMS Asset Alert family.	None
AMS Asset Event Schedule	Character	Specifies how often data should be collected from the specified AMS Analytics data source to create and update records in the AMS Asset Event family.	None
AMS Asset Event History	Numeric	Specifies which AMS Asset Event records should be collected based on when the associated events occurred.	For example, if you wanted to see AMS Asset Event records for events that took place only over the past two months, you would the number 2 and then select the value Months from the list.

Status

The Status section of the AMS Data Source Configuration: New Data Source datasheet stores information about the dates on which data was last collected and the status of the collection process.

This section provides an alphabetical list and description of the fields that exist in the Status section and appear on the AMS Data Source Configuration: New Data Source datasheet. The information in the table reflects the baseline state and behavior of these fields.


Field	Data Type	Description	Behavior and Usage
AMS Asset Alert Last Successfully Processed Date	Character	Stores the date and time on which data for the AMS Asset Alert family was collected from the specified AMS Analytics data source.	The field is populated automatically after the collection process for the AMS Asset Alert family is executed successfully.
AMS Asset Alert Last Processed Status	Character	Stores a value that indicates if there were errors while collecting AMS Asset data.	This field is populated automatically after the collection process for the AMS Asset Alert family is complete. If no errors occurred, the value Good will appear. If errors have occurred, this value will reflect the type of error that occurred (e.g., Fatal Error). If the CMMS Data Source check box on the Web Service Details tab is selected, this value will always be N/A.
AMS Asset Event Last Successfully Processed Date	Numeric	Stores the date and time on which data for the AMS Asset Event family was collected from the specified AMS Analytics data source.	The field is populated automatically after the collection process for the AMS Asset Event family is executed successfully.
AMS Asset Event Last Processed Status	Character	Stores a value that indicates if there were errors while collecting AMS Asset Event data.	This field is populated automatically after the collection process for the AMS Asset Event family is complete. If no errors occurred, the value Good will appear. If errors have occurred, this value will reflect the type of error that occurred (e.g., Fatal Error). If the CMMS Data Source check box on the Web Service Details tab is selected, this value will always be N/A.
AMS Asset Last Successfully Processed Date	Numeric	Stores the date and time on which data for the AMS Asset family was collected from the specified AMS Analytics data source.	The field is populated automatically after the collection process for the AMS Asset family is executed successfully.
AMS Asset Last Processed Status	Character	Stores a value that indicates if there were errors while collecting AMS Asset data.	This field is populated automatically after the collection process for the AMS Asset family is complete. If no errors occurred, the value Good will appear in the field. If errors have occurred, this value will reflect the type of error that occurred (e.g., Fatal Error).

Family Field Descriptions: AMS Analytics

This topic provides a listing of all the families in the AMS Analytics module, with links to the family fields information.

AMS Asset Records

AMS Asset records store values that are transferred from the AMS Analytics data source. The information in this topic reflects the baseline state and behavior of these fields. All fields in AMS Asset records are read-only and are populated automatically when you transfer data from the AMS Analytics data source.

This family is enabled for site filtering, which means that records in this family can be assigned to a specific site, and will then only be accessible to users who are assigned to the same site and have the appropriate license and family privileges. For more information, refer to the Site Filtering section of the documentation.

AMS Asset records include the following fields:

Criticality
Description
Functional Location Path
Health Index
ID
Last Known Tag Path
Manufacturer
Model
Name
Protocol
Revision
Tag Path
Type

AMS Asset Alert Records

AMS Asset Alert records store values that are transferred from the AMS Analytics data source. The information in this topic reflects the baseline state and behavior of these fields. All fields in AMS Asset Alert records are read-only and are populated automatically when you transfer data from the AMS Analytics data source.

This family is enabled for site filtering, which means that records in this family can be assigned to a specific site, and will then only be accessible to users who are assigned to the same site and have the appropriate license and family privileges. For more information, refer to the Site Filtering section of the documentation.

AMS Asset Alert records include the following fields:

Active?
AMS Asset ID
Date/Time
Description
Help
ID
Severity

AMS Asset Event Records

AMS Asset Event records store values that are transferred from the AMS Analytics data source. The information in this topic reflects the baseline state and behavior of these fields. All fields in AMS Asset Event records are read-only and are populated automatically when you transfer data from the AMS Analytics data source.

This family is enabled for site filtering, which means that records in this family can be assigned to a specific site, and will then only be accessible to users who are assigned to the same site and have the appropriate license and family privileges. For more information, refer to the Site Filtering section of the documentation.

AMS Asset Event records include the following fields:

AMS Asset ID
Analyst
Certainty
Date/Time
Description
Operational Significance
Recommended Actions
Severity
Status
Type
Urgency

AMS Asset Folder Records

AMS Asset Folder records store calculated composite health index values based upon related AMS Asset records. This topic provides an alphabetical list and description of the fields that exist for the AMS Asset Folder family. The information in the topic reflects the baseline state and behavior of these fields.

This family is enabled for site filtering, which means that records in this family can be assigned to a specific site, and will then only be accessible to users who are assigned to the same site and have the appropriate license and family privileges. For more information, refer to the Site Filtering section of the documentation.

The following fields in AMS Asset Folder records are read-only and are populated automatically when you transfer data from the AMS Analytics data source:

Health Index: Stores the composite health index value the indicates the overall health of all the assets associated with the AMS Asset Folder record. This field contains a value calculated by a rule, which determines the composite health index value based upon the health index values and criticality values that are stored in the AMS Asset records that are linked to the AMS Asset Folder record. This value is calculated each time data is transferred to the GE Digital APM database from an AMS Analytics data source. By default, the Health Index field is not included on the AMS Asset Folder datasheet.
Name: The name of the AMS Asset Folder record.

AMS Asset Recommendation Records

AMS Asset Recommendation records contain information about recommendations related to AMS Assets. This topic provides an alphabetical list and description of the fields that exist for the AMS Asset Recommendation family. The information in the topic reflects the baseline state and behavior of these fields. This list is not comprehensive; instead, it is limited to field behavior that differs from General Recommendations.

The table lists datasheet captions, not field captions.

This family is enabled for site filtering, which means that records in this family can be assigned to a specific site, and will then only be accessible to users who are assigned to the same site and have the appropriate license and family privileges. For more information, refer to the Site Filtering section of the documentation.


Field	Data Type	Description	Behavior and Usage
Asset ID	Character	The value in the Equipment ID field of the Equipment record to which the Recommendation record is linked.	This field is populated automatically when the AMS Asset Recommendation record is created. If the AMS Asset Recommendation record is not linked to an Equipment record, this field will be empty.
Description	Text	A short description of the recommended action.	When the record is created based on an AMS Asset Alert record, this field is populated automatically with the value in the Help field in the associated AMS Asset Alert record.
Functional Location	Character	The value in the Functional Location field of the Functional Location record to which the Recommendation record is linked.	This field is populated automatically when the AMS Asset Recommendation record is created. If the AMS Asset Recommendation record is not linked to a Functional Location record, this field will be empty.
Headline	Character	A short description of the recommended action.	This field is populated automatically with the value that appears in Description field in the AMS Asset Alert or AMS Asset Event record to which the AMS Asset Recommendation record is linked.
Priority	Character	The priority of the recommended action.	N/A

Catalog Items: AMS Analytics

This topic provides a listing of all the Catalog folders used by the AMS Analytics module, with links to the folder information.

Dashboard Folder

The Catalog folder \\Public\Meridium\Modules\AMS Asset Portal\Dashboard contains the following items.

Note: Only the Catalog items used in the current version of GE Digital APM are included in this table. However, items used in previous versions are still available in the Catalog.


Graph Name	Behavior and Usage
Active Alerts by Asset Criticality	Displays active AMS Asset Alerts according to the criticality of related AMS Assets. This graph is displayed on the AMS Analytics Overview page (Active Alerts by Asset Criticality graph).
Active Alerts by Severity	Displays active AMS Asset Alerts according to their severity. This graph is displayed on the AMS Analytics Overview page (Active Alerts by Severity graph).
Assets by Criticality	Displays AMS Assets according to their criticality. This graph is displayed on the AMS Analytics Overview page (Assets by Criticality graph).

Graphs Folder

The Catalog folder \\Public\Meridium\Modules\AMS Asset Portal\Graphs contains the following items.

Note: Only the Catalog items used in the current version of GE Digital APM are included in this table. However, items used in previous versions are still available in the Catalog.


Graph Name	Behavior and Usage	Notes
Active AMS Alerts By Duration	Displays the amount of time that AMS Asset Alerts have been active. This graph is displayed on the AMS Analytics Overview page (Active Alerts by Duration graph).	None
AMS Alert Trend	Displays the number of active AMS Asset Alerts each month for the past year. This graph is displayed on the AMS Analytics Overview page (Alert Trend graph).	None
AMS Asset Events By Type	Displays AMS Asset Events according to their event type. This graph is displayed on the AMS Analytics Overview page (Events by Type graph).	None
AMS Assets by Type	Displays AMS Assets according to their asset type. This graph is displayed on the AMS Analytics Overview page (Assets by Type graph).	None
Assets by Health Index	Displays AMS Assets according to their health index (i.e., Health Index field in AMS Asset records). This graph is displayed on the AMS Analytics Overview page (Assets by Health graph).	None
Asset Alert Trend by Description	Displays, categorized by description, the AMS Asset Event records that are linked to a specified AMS Asset record and for which active AMS Asset Alert records exist. When you view an alert trend for an AMS Asset, this graph appears if you select Alerts by Description.	None
Asset Alert Trend by Severity	Displays, categorized by description, the AMS Asset Event records that are linked to a specified AMS Asset record and for which active AMS Asset Alert records exist. When you view an alert trend for an AMS Asset, this graph appears if you select Alerts by Severity.	None

Queries Folder

The Catalog folder \\Public\Meridium\Modules\AMS Asset Portal\Queries contains the following items.

Note: Only the Catalog items used in the current version of GE Digital APM are included in this table. However, items used in previous versions are still available in the Catalog.


Item Name	Behavior and Usage
Active Alerts by Asset Criticality	The results of this query are used by the Active Alerts by Asset Criticality graph on the AMS Analytics Overview page.
Active Alerts by Severity	The results of this query are used by the Active Alerts by Severity graph on the AMS Analytics Overview page.
Active AMS Alerts By Duration	The results of this query are used by the Active AMS Alerts By Duration graph on the AMS Analytics Overview page.
Alert Trend by Asset	The results of this query are used by the Asset Alert Trend by Severity graph.
Alert Trend by Asset by Event Description	The results of this query are used by the Asset Alert Trend by Description graph.
Alert Trend Over Year by Hierarchy	The results of this query are used by the Alert Trend graph on the AMS Analytics Overview page.
All Assets by Type	The results of this query are used by the Assets by Type graph on the AMS Analytics Overview page.
AMS Overview - Active Alerts	Returns AMS Asset Alerts that are marked as active and related to a selected level of the Asset Hierarchy. The results of this query are displayed in the Active Alerts list on the AMS Analytics Overview page.
AMS Overview - Active Recommendations	Returns open AMS Asset Recommendations (i.e., recommendations where the state is not closed, superseded, or rejected) related to a selected level of the Asset Hierarchy (i.e., linked directly to an asset in the selected level or linked to an AMS Asset that is linked to an asset in the selected level). The results of this query are displayed in the Recommendations list on the AMS Analytics Overview page.
AMS Overview - AMS Assets by Asset Hierarchy	Returns the AMS Asset records related to a selected level of the Asset Hierarchy. The results of this query are displayed in the AMS Assets list on the AMS Analytics Overview page.
AMS Overview - Events	Returns AMS Asset Events related to a selected level of the Asset Hierarchy and whose date is within a specified time range. The results of this query are displayed in the Events list on the AMS Analytics Overview page.
AMS Overview - Reports	Returns a list of the reports located in the Catalog folder \\Public\Meridium\Modules\AMS Asset Portal\Summary Reports. The results of this query are displayed in the Reports list on the AMS Analytics Overview page.
Asset Events By Type	The results of this query are used by the Events By Type graph on the AMS Analytics Overview page.
Assets by Criticality	The results of this query are used by the Assets by Criticality graph on the AMS Analytics Overview page.
Assets by Health Index	The results of this query are used by the Assets by Health graph on the AMS Analytics Overview page.

Detailed Reports Folder

The Catalog folder \\Public\Meridium\Modules\AMS Asset Portal\Detailed Reports contains the following items.

Note: Only the Catalog items used in the current version of GE Digital APM are included in this table. However, items used in previous versions are still available in the Catalog.


Report Name	Behavior and Usage
Device Manager subfolder
Alert Details Report	Displays all the information that is available for a given AMS Asset Alert record that exists in the AMS Device Manager data source, including information about records that are linked to the AMS Asset Alert record.
Asset Details Report	Displays all the information that is available for a given AMS Asset record that exists in the AMS Device Manager data source, including information about records that are linked to the AMS Asset record.
Event Details Report	Displays all the information that is available for the specified AMS Asset Event record that exists in the AMS Device Manager data source, including information about records that are linked to the AMS Asset Event record.
Machinery Manager subfolder
Alert Details Report	Displays all the information that is available for a given AMS Asset Alert record that exists in the AMS Machinery Manager data source, including information about records that are linked to the AMS Asset Alert record.
Asset Details Report	Displays all the information that is available for a given AMS Asset record that exists in the AMS Machinery Manager data source, including information about records that are linked to the AMS Asset record.
Event Details Report	Displays all the information that is available for a given AMS Asset Event record that exists in the AMS Machinery Manager data source, including information about records that are linked to the AMS Asset Event record.
Performance Advisor subfolder
Alert Details Report	Displays all the information that is available for a given AMS Asset Alert record that exists in the AMS Performance Advisor data source, including information about records that are linked to the AMS Asset Alert record.
Asset Details Report	Displays all the information that is available for a given AMS Asset record that exists in the AMS Performance Advisor data source, including information about records that are linked to the AMS Asset record.
Performance Monitor subfolder
Alert Details Report	Displays all the information that is available for a given AMS Asset Alert record that exists in the Performance Monitor data source, including information about records that are linked to the AMS Asset Alert record. This report displays the information that is stored only in the GE Digital APM database. The Performance Monitor does not contain additional information about AMS Asset Alert records that is not already stored in GE Digital APM.
Asset Details Report	Displays all the information that is available for a given AMS Asset record that exists in the Performance Monitor data source, including information about records that are linked to the AMS Asset record.
Event Details Report	Displays all the information that is available for a given AMS Asset Event record that exists in the Performance Monitor data source, including information about records that are linked to the AMS Asset Event record. This report displays the information that is stored only in the GE Digital APM database. The Performance Monitor does not contain additional information about AMS Asset Event records that is not already stored in GE Digital APM.

Summary Reports Folder

The Catalog folder \\Public\Meridium\Modules\AMS Asset Portal\Summary Reports contains the following items.


Name	Item Type	Behavior and Usage
Active Alert Breakdown	Graph	Graph that displays AMS Asset records grouped by the value in the Severity field of the AMS Asset Alert records that are linked to that AMS Asset record.
Alert Trend	Graph	Graph that displays the number of AMS Asset Alert records whose date and time values fall within a specified time frame.
Assets by Data Source	Graph	Graph that displays AMS Asset records grouped by the data source from which they originated. This graph displays information from ALL data sources that appear in the tree.
Degraded Asset Report	Query	Query that displays the total number of AMS Asset records that contain a health index value that is lower than 100.
Event Description Breakdown Report	Report	Report that displays the number of AMS Asset Event records, grouped by the data source from which they originated, whose event type, start date, and end date match a specified set of criteria.
Event Trend Daily	Report	Report that displays the number of AMS Asset Event records, grouped by the data source from which they originated, whose event type, description, and end date match a specified set of criteria. This report shows only the AMS Asset Event records whose date and time falls within the 10 days prior to the end date that you specified in the prompt when running the report.
Event Trend Monthly	Report	Report that displays the number of AMS Asset Event records, grouped by the data source from which they originated, whose event type, description, and end date match a specified set of criteria. This report shows only the AMS Asset Event records whose date and time falls within the 12 months prior to the end date that you specified in the prompt when running the report.
Plant Health Report	Query	Query that displays summary information about the overall health of the equipment and locations per plant.
Problematic Assets	Query	Query that displays AMS Asset records with high criticality values and low health index values.