APM Release Notes for the Second Quarter of 2018 | Predix APM

Help System

The GE Digital Applications Information Development team is excited to present our new documentation portal for GE Digital applications documentation.

Documentation Build Date: April 25, 2018

What has changed in this release?

This portal is currently available for legacy Predix cloud solutions for APM and OPM. It will soon be expanded to become the centralized location for all end-user documentation for GE Digital applications.

The new portal offers a streamlined presentation of content and will have additional capabilities and enhancements added over time to help you find the answers you need fast.

Here are some of the features available now:

The portal is presented with an updated look and feel with responsive design accessible on smaller screens, tablets, and mobile devices.
APM and OPM have their respective document landing pages.
The standardized modular document architecture has been carried forward from existing webhelp into the new portal.
Contents are organized in functional groups for each product with selectable navigation links.
Search is available at product and module levels.
A new In this Document drop-down is accessible on the top-right of the each content page. Use this menu to navigate to a specific section of the page.

The following tables show a comparison between the previous webhelp and the new documentation portal.

Table 1. APM
Navigation Link in the previous webhelp	Navigation Link in the new product landing page	New logical Grouping
Access APM	User Settings	Administration
Troubleshooting	Troubleshooting
Manage Users and Permissions	Users and Permissions
Provision Tenants	Ingestion
Provision Tenants	Tenant Setup
Manage Units of Measure Conversions	Units of Measure Conversions
Manage Audit Logs	Audit Logs
Manage Time Series Data	Time Series Data
Technical Specifications	APM System Requirements	Basics
APM Overview	Getting Started
Release Notes	Release Notes
Developer Documentation	Developer	Developer
Manage APM Extensibility	Extensibility	Developer
Manage Edge Analytics	Edge Analytics	Reliability
Manage Analytics	Application Analytics
Manage Case Templates	Case Templates
Manage SmartSignal	SmartSignal
Manage Cases	Cases
Manage Alerts	Alerts	Health
Manage Alert Templates	Alert Templates
Manage Assets	Assets
Manage Analysis	Analysis
Manage Dashboard	Dashboard	Tools

Table 2. OPM
Previous Grouping and Navigation Link	New logical Grouping	Module Link
Manage OPM	Administration	Release Notes
	Administration	Getting Started with OPM
	Developer	Developer Documentation
	Operational Intelligence	KPI Benchmarking Analysis
	Operational Intelligence	Geospatial Analysis
	Forecasting and What-If Analysis	Forecasting

Known Limitations

The topic navigation is only scrollable after scrolling to the bottom of the content page. This is typically not an issue with shorter navigation menu, but, for modules with long navigation menus, you must first scroll to the bottom of the active content page, and then continue scrolling through the left navigation.
Both the Latest release notes and Recently updated lists show the top three most recently published modules, whether or not the release notes were actually updated.

Documentation Feedback

To share feedback on the documentation portal or to report issues, please send your comments to mailto:apm-docfeedback@ge.com. We appreciate your feedback.

Alerts and Cases

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 3. Enhancements and New Features
Note	Tracking ID
You can create a case from multiple alerts using Bulk Actions so that you can group similar alerts together for an incident.	US187104 US187103
You can now add a link in the case details so that you can open and access these link from the case and view the details.	US251249
The cases are now displayed in tabular format as a grid unless you have selected the Inbox view.	US251226
You can now select the Case Inbox or Grid view as your preferred view.	US251227
You can now export selected cases using an API.	US255782
You can now add a web address to the Evidence section.	US251254
You can now delete the web address that you have added in the Evidence section.	US257092
The alerts are now displayed in tabular format as a grid unless you have selected the Inbox view.	US251222
You can now set the Alert Inbox or Grid view as your preferred view.	US251223

Table 4. Resolved Issues
Note	Tracking ID
Previously, you were unable to fetch cases using an API. This issue has been resolved.	DE71228
Previously, in the Cases grid view, when you sorted the cases by the Case ID, the last two rows were missing. This issue has been resolved.	DE71735
Previously, even if a field had not been modified, you would have received an email notification. This issue has been resolved.	DE64461
Previously, when you attempted to create a case with the name of a case that contained more than 100 characters, an error occurred. This issue has been resolved. Now, you can create a case with a case name of up to 255 characters.	DE75187
Previously, if the name of the case contained more than 100 characters, the case name was not displayed. This issue has been resolved.	DE75188
Previously, even when you updated the same value for an entry in a case, an email notification was sent. This issue has been resolved.	DE71269
Previously, when you had attached an image in the evidence, the Linked Alert email notification was sent. This issue has been resolved. Now, only if you link an alert to a case, the Linked Alert email notification will be sent.	DE79275
Previously, if the case name contained # symbol, you could not open an alert from the Evidence section of a case. This issue has been resolved.	DE69179
Previously, when you had attached a file to a case, you would have received severity updated notification in addition to attachment added notification. This issue has been resolved. Now, when you attach a file to a case, you will receive only the attachment added notification.	DE68314
Previously, from the Alerts grid view, when you attempted to access the Alerts Details page, the page did not open if the alert name contained slash (/) symbol. This issue has been resolved.	DE70834
Previously, when you attempted to access the Alerts Details page from the linked alerts, the page did not open if the alert name contained /, ?, \ symbols. This issue has been resolved.	DE70857
Previously, you could claim alerts owned by other users. This issue has been resolved.	DE66255
Previously, in the Alert Details page, the timestamp in the First Occurrence and Last occurrence fields were incorrect. However, in the Grid view, the timestamp was correct. This issue has been resolved.	DE68547

Release Date: April 27, 2018

Table 5. Enhancements and New Features
Note	Tracking ID
In the previous release, the email notification on Alerts and Cases included only a link to the Alert and Cases details. Now, the email notification includes a link and the following details: User Name Asset Name Asset ID Asset Site Name User Action	N/A

Alert Templates and Case Templates

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 6. Enhancements and New Features
Note	Tracking ID
The Case Templates are now displayed in a tabular format.	US248372
You can now filter the Case Templates using the header column of the grid.	US248373
You can now choose to show or hide columns of a Case Template.	US248375
You can now sort a column of a Case Template grid either in ascending or descending order.	US251085
You can now view the Case Templates grid in your preferred language.	US187104 US187103
The Alert Templates are now displayed in a tabular format.	US251076
You can now filter the Alert Templates using the header column of the grid.	US251083
You can now choose to show or hide columns of an Alert Template.	US251088
You can now sort the columns of an Alert Template grid either in ascending or descending order.	US251086
You can now export selected Alert Templates instead of all the templates.	US255781
You can now view the Alert Templates grid in your preferred language.	US251082

Table 7. Resolved Issues
Note	Tracking ID
Previously, when analysis template and alerts failed to load, an error message appeared, displaying the message in both English and Polish even if you had set your preferred language as Polish. This issue has been resolved.	DE49977
Previously, when you had imported a template, it had overridden the templates that were modified by another user. This issue has been resolved.	DE73120
Previously, when you attempted to create a case from an alert using the case template ingested from an API, the case was not created. This issue has been resolved.	DE66244
Previously, when you attempted to create an Alert Template, the Source and Type values were displayed in another language. This issue has been resolved.	DE45622

Analysis

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 8. Enhancements and New Features
Note	Tracking ID
Plot tags in a tabular format.	N/A
Display data quality flag.	N/A
Add tag threshold to charts.	N/A
View tags and tag values in tag register.	N/A
Gradient across Parallel Axis and Spider charts.	N/A
Enhancements to Event Data Analysis.	N/A

Table 9. Known Issues
Note	Tracking ID
When you export data from a data table, the asset names are not included in the export.	DE79153

Release Date: May 14, 2018

Table 10. Resolved Issues
Note	Tracking ID
The data quality flags from Historian and other data sources do not match the time series data quality flags. Filtering out bad data for any data sources other than Predix TimeSeries is disabled. If asset tags are configured to point to Historian tags, then there will be issues displaying data for that tag.	DE74666

Release Date: April 27, 2018

Table 11. Resolved Issues
Note	Tracking ID
When viewing an analysis template from an Alert, then the option to change the System of Measure on the fly does not work.	DE70668
When viewing an analysis template from an Alert, then the UoM of the tags does not convert correctly.	DE70593
When viewing an analysis template associated with an Alert, then the tags used in the tag expression do not convert correctly.	DE70592

Analytics

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 12. Enhancements and New Features
Note	Tracking ID
Added support for flexible analytic input mapping, allowing multiple analytic inputs to be mapped to the same input tag.	F34828
Deploy Analytics to assets in an equipment template. During the 1.Asset Selection step in Deployment, search and browse through a list of available equipment templates to select an equipment template for deployment. Use Tags and Attributes available in the Equipment Template to perform I/O mapping for the analytic inputs, constants, and outputs.	F33386
Access the SmartSignal Analytic Maintenance application from the Deployment page in Application Analytic app.	F34831
Added support to schedule analytics using raw data per input tag. The Tabular and Interpolated data options are still supported.	F34847
Ability to map asset attributes to analytic input and output definitions, so that the analytic inputs can be retrieved and results written to the configured asset attribute.	F30566
Ability to provide notes and disposition in Alerts ingestion JSON.	F34846

Table 13. Known Issues
Note	Tracking ID
The CSV file upload is one way to quickly import input definition, constants, and output definitions into an existing analytic template. However, the CSV template does not provide the column to input the Data Format values. You must define the Data Format only through the UI. The updated CSV template will capability will be available in the next release.	DE78361

Release Date: April 27, 2018

Table 14. Enhancements and New Features
Note	Tracking ID
Ability to ingest, configure, and deploy analytics to the Edge Analytics Runtime (Limited Availability - available on request only) Users can download and install the Edge Analytics Editor to create analytics. This is accessible from the Edge Manager repository for the (cloud) application tenant.	N/A

Table 15. Resolved Issues
Note	Tracking ID
For analytics deployed to the Spark Runtime and scheduled to Runonce; even though the `interpolated` option is selected, the data always returns as raw data from timeseries instead of the expected interpolated results.	DE69377
Even though a deployment only requires either the output definition or output event to be configured correctly in an analytic template, Application Analytics does not allow the user to create deployments using a template that does not have output definitions. Even if the Deployment tab is enabled, the user cannot create deployments and the following error message appears: `Unable to create deployment as there are no 'outputs' for the <analytic_template> analytic`.	DE64793

Table 16. Limitations
Note	Tracking ID
See the March 30, 2018 release notes for Edge Analytics.	N/A

Table 17. Known Issues
Note	Tracking ID
See the March 30, 2018 release notes for Edge Analytics.	N/A

APM Extensibility

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 18. Enhancements and New Features
Note	Tracking ID
You can now preserve the content (such as case templates, alert templates, and asset classifications) and navigation settings that are already in use within a tenant when you subscribe a new product into an existing tenant.	N/A
You can now use the profile variable to automatically update the instance of a widget to use within the dashboard of a particular tenant.	N/A

Asset

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 19. Enhancements and New Features
Note	Tracking ID
Ability to create a classification using the UI.	N/A
Display of related Alerts and Cases on the Asset Faceplate for the Timeline and Grid views.	N/A

Table 20. Known Issues
Note	Tracking ID
Unable to ingest a tag with tagType as computed or sensor.	DE76027
If a network is part of a sub-network, then it is not searchable.	DE75564
Reserved Attributes Advanced search not working when system has large volumes of reserved attributes.	DE75378
Get tags for query (q=monitoredEntityUri->parent→type) does not work.	DE74499
[Unified App]- Intermittently unable to see ingestion logs in IE (in unified tenant).	DE73709
[Unified App] Asset restrictions menu item in the left nav does not appear when logged in for the first time.	DE73123
Internal server error is thrown if user sends request with Malformed URL.	DE68896
Newly created alert (count) is not seen immediately without refreshing the page (Date picker is not reflecting current time)	DE61811
Timestamp is incorrect if time zone in user preferences is set to UTC + 14(Kiritimati)	DE57601
After clicking on the asset ID of an alert in the Alerts Inbox the system will navigate to the Asset Faceplate. If the alert creation date is older than 30 days the alert will not automatically display in the Events Tab. Customers will have to manually change the calendar date range to a time period which includes the alert creation date.	DE57273

Release Date: June 6, 2018

Table 21. Enhancements and New Features
Note	Tracking ID
Ability to create an asset instance using the UI.	N/A

Table 22. Known Issues
Note	Tracking ID
Unable to ingest a tag with tagType as computed or sensor.	DE76027
If a network is part of a sub-network, then it is not searchable.	DE75564
Reserved Attributes Advanced search not working when system has large volumes of reserved attributes.	DE75378
Get tags for query (q=monitoredEntityUri->parent→type) does not work.	DE74499
[Unified App]- Intermittently unable to see ingestion logs in IE (in unified tenant).	DE73709
[Unified App] Asset restrictions menu item in the left nav does not appear when logged in for the first time.	DE73123
Internal server error is thrown if user sends request with Malformed URL.	DE68896
Newly created alert (count) is not seen immediately without refreshing the page (Date picker is not reflecting current time)	DE61811
Timestamp is incorrect if time zone in user preferences is set to UTC + 14(Kiritimati)	DE57601
After clicking on the asset ID of an alert in the Alerts Inbox the system will navigate to the Asset Faceplate. If the alert creation date is older than 30 days the alert will not automatically display in the Events Tab. Customers will have to manually change the calendar date range to a time period which includes the alert creation date.	DE57273

Release Date: April 27, 2018

Table 23. Enhancements and New Features
Note	Tracking ID
The Network model and UI containing the following functionality: Search for specified networks. Network panel with sub-network, node, edge, reserved attribute, and custom attribute sections. Navigation to related asset instances. Network panel section filtering. Selections from the network map. Zooming and pan the network display. Resizing the network map.	N/A

Table 24. Limitations
Note	Tracking ID
It is recommended that networks be limited to 1,500 nodes and edges. Searching edges or nodes will become progressively slower the larger the network becomes.	N/A

Table 25. Known Issues
Note	Tracking ID
Users who provided malformed URLs, of the format with two // characters side by side, previously the system would process the URL as if only one / were present. If this malformed URL is presented now the system will generate an error.	DE68896
Newly created alert (count) is not seen immediately without refreshing the page (Date picker is not reflecting current time)	DE61811
Timestamp is incorrect if time zone in user preferences is set to UTC + 14(Kiritimati)	DE57601
After clicking the Asset ID of an alert in the Alerts Inbox, the system will navigate to the Asset Faceplate. If the alert creation date is older than 30 days, the alert will not automatically display in the Events tab. Workaround: Customers should manually change the calendar date range to a time period that includes the alert creation date.	DE57273

Dashboard

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 26. Enhancements and New Features
Note	Tracking ID
New Dashboard browser.	N/A
Use tag expressions in Dashboard.	N/A
Limit dashboards to Enterprises and User Groups.	N/A
With view only access, you can now view existing dashboards and create a private dashboard.	N/A

Table 27. Known Issues
Note	Tracking ID
Significant Digits for tag expressions do not display on widget.	DE76014
You cannot add in another asset context to an existing tag expression in a dashboard.	DE78544
Save button for dashboard disappears when you cancel out of an asset context.	DE79103
Add assets from different classification to class dashboard through the Add Asset Filter option.	DE80102

Release Date: May 21, 2018

Table 28. Resolved Issues
Note	Tracking ID
The Generic Graph widget, Generic Graph Interactive widget, and Ambient Conditions widget do not filter out bad quality data.	DE75866

Release Date: April 27, 2018

Table 29. Enhancements and New Features
Note	Tracking ID
Removed Bar V1 version Widget from the widget repository.	N/A
Updated TimeSeries API on all widgets to V4 version.	N/A
Get Latest Data point for a tag, only looks for a value used within the last 15 days and not one year.	N/A

Table 30. Resolved Issues
Note	Tracking ID
Console errors display when adding a fixed card to a Dashboard.	DE73216
When adding a tag with bad data quality, then the Dashboard displays console errors. The correct behavior is for the tags to not display in the widget.	DE72747
If the tag does not have any data in the last 15 days, then the widget does not display any data.	DE72410
Dashboard loads with more than 250 enterprises.	DE70569
Widget searches for a tag in first 1000 tags.	DE67299
If the data service is not available, then the previously available data displays on the chart.	DE67100
Time series timeout message displays in widget when the time series calls time out.	DE66696
The model browser loads when certain deployments do not have input or output tag configured.	DE57255

SmartSignal

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 31. Enhancements and New Features
Note	Tracking ID
You can now view the rule assignments for an Analytic Template of the SmartSignal type in the Rule Assignment section of the page for a selected Analytic Template.	US257978
In SmartSignal Maintenance, in the page for a selected Model, you can now view values for the following fields: Residual Variance Actual Mean Actual Standard Deviation	US257665
You can now synchronize an Analytic Template across multiple Deployments.	US257663
You can now view the formula for an output tag in the Tag Alias column in the page for a Deployment. To facilitate this enhancement, a calculator button () now appears next to the value in the Tag Alias field.	US257628
You can now view the health of an output tag used in a Deployment and, as needed, inactivate an output tag so that it will not be used to create data.	US257625

Release Date: April 27, 2018

Table 32. Limitations
Note	Tracking ID
The Import Training Data option for creating a model in SmartSignal Maintenance does not currently support the use of String Tag data types in Mode or Output Tag expressions.	US250217

Units of Measure Conversions

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 33. Resolved Issues
Note	Tracking ID
Previously, the Rankine to Kelvin formula was same as the Kelvin to Rankine formula. This issue has been resolved. Now, the Rankine to Kelvin formula has been updated.	DE75358
Previously, in place of mile or miles, mil or mils were used inappropriately because mile and miles were unavailable in the system. mil and mils represent thousandth of an inch unit. This issue has been resolved. Now, mile and miles have been added to the units of measurements and the related formulae have been corrected.	DE75358

User Settings

This topic provides a list of product changes released for this module on the dates listed below

Release Date: June 29, 2018

Table 34. Enhancements and New Features
Note	Tracking ID
GE Digital APM now supports the following six new languages: Chinese (Simplified) Dutch (Netherlands) Italian (Italy) Japanese Portuguese (Brazil) Spanish (Spain)	US259336

Tenant Preferences

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 35. Enhancements and New Features
Note	Tracking ID
GE Digital APM now supports the following six new languages: Chinese (Simplified) Dutch (Netherlands) Italian (Italy) Japanese Portuguese (Brazil) Spanish (Spain)	US259336

Time Series Data

This topic provides a list of product changes released for this module on the dates listed below.

Release Date: June 29, 2018

Table 36. Resolved Issues
Note	Tracking ID
Date time field values do not get ingested correctly.	DE76034
When time series link is empty, query API displays more descriptive error message identifying the issue.	DE74536

Release Date: April 27, 2018

Table 37. Resolved Issues
Note	Tracking ID
Ingestion to support NaN in the following three File_types: ODBExportCSV, ProficyFileCollectorCSV, and JSON. ODBExportCSV - NaN is ingested as "0" and Bad Quality. ProficyFileCollectorCSV - NaN is ingested as "0" and Quality as specified in the file. JSON - NaN is ingested as "0" and Quality as specified in the file. In all formats, if NaN is ingested as a string, then it will be stored as a string.	DE71048

Table 38. Obsolete Features
Note	Tracking ID
In Time Series Data, the /v1 endpoints from the apm-timeseries-query-svc application have been deprecated. Consumers of the query endpoint should migrate to /v2 or above versions of the existing apm-timeseries-query-svc. In addition, ingestion functionality from the apm-timeseries-query-svc application have been removed. Ingestion functionality will be available in the new module, apm-timeseries-ingestion-svc, which improves performance and adaptability. Consumers of the ingestion endpoints on the existing apm-timeseries-query-svc should migrate to use the /v2 version endpoint on the new ingestion service, apm-timeseries-ingestion-svc. You can find more information about these endpoints and the functionality they provide in the Time Series Data API documentation at https://apm-apidocs-rc.int-app.aws-usw02-pr.predix.io/.	N/A