APM Release Notes v2.6
Provides a list of new and updated features for this release, as well as any resolved issues, limitations, and known issues.
Release Information
Product: Predix APM (Asset Performance Management)
Release Number: Version 2.6
Release Date: April 13, 2017
New and Updated Features
This release contains updates only for the following modules.
Alerts:
- Added the ability to manually create an alert at any level of the asset hierarchy.
- Added new custom filters for alerts.
- Added the ability to create a recurring (reminder) alert.
- Added the ability to select a case template when creating a case from an alert.
- Added Linked Cases, Alert Source, and Alert Type columns to the Alerts grid table.
- Added new permissions for Alerts: View Alert Detail, Manage Alerts, View Notes, and Manage Notes.
Cases:
- Added the ability to sort columns in the grid view for cases.
- Added the ability to filter columns in the grid view for cases.
- Added the ability for an analyst to view custom sections in a PDF report for cases.
Configurable Templates:
- Updated the Analysis Templates option for Alert Templates with the addition of the Pre-Event Time, Post-Event Time, and Data Resolution columns.
- New attributes – Sequence, Form UUID, Form Name, and Form Type – were added to the Master Template for Cases.
- Added the Configure Section button, which provides the ability for a user to configure the forms that appear when creating a case template.
- Added the ability to view the Analysis templates associated with a case, which are displayed in a list in the Analysis section of the case details.
Data:
- Ability to connect to external Predix data source.
- Support for time series data attributes in ingestion and retrieval services.
- Support for aggregation functions for time series data retrieval (sum and avg).
Analysis:
- Ability to add different combinations of charts to a view:
- Insert new cards from view or from card.
- Edit the card name.
- Delete cards.
- Use jump menu to navigate cards.
- Add charts to a card.
- Plot reference curve and save in a template.
- Change the date range and data resolution for multiple charts in view.
- Toggle between tag names and aliases in view.
- Export chart data.
- Edit the chart name.
- Delete charts.
- Save Assets with plotted tags to template (includes reference curves and tag expressions).
- Delete an analysis template not associated with an alert template.
- List alert templates associated with analysis templates.
- Show and hide template information.
- Ability to view tag tree browser:
- View tag tool tips on hover.
- Select and plot single or multiple tags simultaneously from tag tree browser.
- Remove tags from a view.
- Add multiple assets.
- Remove assets.
- Globally mute and unmute tags.
- Search the tag tree browser.
- Added enhanced tag filtering:
- Can filter tag data to a custom range (minimum and maximum values).
- Invert filter values for a tag.
- Reset filters.
- Remove filters.
- Added tag tool tip enhancements, including the ability to display and hide tag information in table form, and display asset faceplate from tag information table.
- Added enhanced advanced search features in search pane:
- Can toggle between tag names and aliases.
- Can select and plot multiple assets or tags.
- Can use text string or modifier to search.
- Can search for asset tags, correlated tags, and tags (including tag expression and reference curve).
- Can perform deep search, including for child assets.
- Added enhanced multi Y-axis support:
- Add and remove Y-axes on a chart (only for Timeseries).
- Ability to set template data information from alert profile:
- Allow default date range that is set in the alert template.
- Allow default date range that is set in the analysis template if not set in the alert template.
- Allow default data resolution that is set in the alert template.
- Allow default data resolution that is set in the analysis template if not set in the alert template.
- Added enhanced zoom support:
- Zoom and pan chart data.
- Send new set of 1000 points for every zoom.
- Reset zoom for all changes on the chart, such as date range and tags.
- Added support for Tag Expression:
- Create and plot tag expressions.
- Save plotted tag expressions in analysis template.
- Edit and delete tag expressions.
- Added the ability to create system or private templates.
- Added the ability to compare charts side by side, such that a user can select a card layout and save as an analysis template with different layouts on a view.
Resolved Issues
Resolved issues are those defects that have been fixed for the release.
| Tracking ID | Description |
|---|---|
| DE15430 | Resolved an issue where scheduled analytics and orchestrations stopped firing, which was caused by environmental issues in Predix Platform. |
| DE15998 | Resolved an issue such that custom sections in the Case detail now appear in an exported PDF. |
| DE16283 | Resolved an issue where the tool tip did not show the unit of measure in a parallel axis chart or spider chart. |
| DE11442 | Resolved an issue where an intermittent SocketTimeoutException was reported while running an analytic through a recurrent schedule or on-demand execution. |
Limitations
Limitations are issues that document performance or system behaviors that may pertain to things such as the APM application, the operating system, or the browser.
| Function | Limitation |
|---|---|
| SmartSignal | Unit of measurement conversion does not yet work for SmartSignal runtime. |
| APM Analytics | When using the Predix runtime in APM Analytics, the Predix timeseries data store is used by default. If you choose a data source other than Predix Timeseries, Predix runtime cannot leverage data from this store for analytics. Users of SmartSignal or Spark Analytic Runtime, will not be affected by this limitation. |
Known Issues
Known issues are those issues that are documented in the defect tracking system that affect this release, and may be fixed in a future release.
| Tracking ID | Description |
|---|---|
| DE16588 | Concurrent Case Ingestion fails beyond 40 concurrent case ingestions using regular case endpoints. |
| DE18556 | For Alerts, users will not see an error message in the UI indicating that the backend services are down. |
| DE26659 | For Cases, users will not see an error message in the UI indicating that the backend services are down. |
| DE26658 | An analyst has the option to create a case from an Alert created at the Enterprise, Site, or Segment level. However, when the analyst tries to create the case, the analyst receives a 403 error. For this release, it is advised that you not create a case from an Alert that was created at the Enterprise, Site, or Segment level. |
| DE26374 | When selecting an Asset to which a user has permission, you should not select the "All Resources" option. If you do, the user will not be able to view the Alert Inbox and grid. However, any children of "All Resources" will work. |
| DE27456 | Context browser is empty if user has permission to two different assets under the same segment and enterprise. |
| DE27761 | Context browser is empty if user does not have permission to asset. |
| DE28249 | When a class level template has been saved with a template that contains multiple tags, the second tag always shows as not configured when the template is opened on another asset of the same classification, even though the tags exist in the other asset. |
| DE28250 | The labels for the target in parallel axis charts are incorrect. The Distance label represents the phase and the Angle label represents the amplitude. |
| DE88 | When updating a group type with a URI for a tag type that does not exist, an inappropriate exception of 500 INTERNAL SERVER ERROR is returned instead of 404 NOT FOUND. |
| DE89 | When updating a tag group with a URI for a tag that does not exist, then an inappropriate exception of 500 INTERNAL SERVER ERROR is returned instead of 404 NOT FOUND. |
| DE92 | When creating a new tag, the drop-down to select the tag class is not rendering correctly. The drop-down does allow users to select a tag class and does not restrict users from completing the creation of a tag. |
| DE1186 | When retrieving time series data using interpolated operation, the data points of a string type are not being included in the interpolation. Instead, the last calculated data point is returned. |
| DE1336 | When modifying a deployment for an existing analytic, the Last Updated date is not being set to the new date. |
| DE1476 | When searching Asset or Tag Classifications, the performance is impacted if a Contains search is performed with less than 3 characters. Workaround: If this occurs, increase the number of characters in the search string to more than 3 characters, and attempt the search again. If this occurs through an APM Asset API call, the return status code is 502. |
| DE1562 | When analytic has a long name (50 characters or more), the analytic template page does not load. |
| DE7096 | When retrieving time series data using interpolated operation, zero values are returned for data points where no time series data exists at the beginning of the required time range. |
| DE7545 | When a customer ingests an asset instance without a name, the asset cannot be retrieved. |
| DE10184 | When hovering over a tag or asset name in the search results pane of the Classification window, the system will sometimes display a tool tip that does not disappear. This tool tip may block the "back" button on the window, preventing the user from navigating from the current page. |
| DE10602 | When analytic deployment configuration is incomplete, the status displays as "In-Progress" in the summary. |
| DE10737 | When you change the datatype, the value is cleared. You have to re-enter the value before proceeding to Save. |
| DE11132 | Searching for tag classifications intermittently generates a 403 error. |
| DE11223 | APM Asset doesn't support access control at the tag level for this release. This has been scheduled for a future release. |
| DE11250 | When using Internet Explorer and viewing the ingestion log status, if you change the number of rows displayed from 10 to another value, then the display will re-render extremely slowly. The operation may take as long as two and half minutes to display the ingestion log status. |
| DE11413 | When you view an Alert in grid view and select at least one alert in ready state, claims the alert., marks it as processed, and then tries to release the claim, you are able to release the claim. Expected behavior: You should not be able to release the claim of a processed alert. Workaround: Use the Alert details view instead of the grid view to perform any action on a processed alert. |
| DE12739 | Assets created with an incorrect parent or asset type URI cannot be accessed after creation. Workaround: Make sure to provide the correct parent and asset type URI to avoid the creation of inaccessible objects. |
| DE14614 | When re-ingesting time series data for the same timestamp but with different data type or quality values, a duplicate record is created for this data point. |
| DE14840 | When invoking the Search function in APM Asset, either through the API or via the UI, there are characters that, if used as a value, will cause the search to fail. Through the API, all values in key:value pairs are affected. Through the API, pills take two forms: a string, or a key:value pair. In the UI, the string and the value of the key:value pair are affected. In any of these cases, if the affected element contains any of the characters :|\[]()<>.=$ or the special string .., the query will not work. Workaround: To avoid this problem, do not use these characters in a search. |
| DE15308 | The MO dashboard is developed using a px-data-table, which is a wrapper around aha-table. To update fixed column widths, the wrapper (px-data-table) is not providing any option. Hence, this scenario can not be accommodated in this script. This will be scheduled for a future release. |
| DE15351 | After setting up an analytic deployment, clicking Deploy does not return the application from its wait indicator (a spinning icon). Workaround: The analytic has stalled. Re-upload the analytic artifact (jar or zip file) to restage the analytic. |
| DE15545 | Assets are not showing as mapped even though tags were mapped for the input tags. |
| DE15661 | Pressing Enter after editing a pill for Search does not trigger the search. |
| DE15893 | Some ingestion users may notice slowness when ingesting a large number of tags in the same file. When viewing the task status in the asset ingestion screen, the task may appear to indicate that the tag instance is not ingested when in fact it has. Workaround: Navigate to the tag instance detail page screen to verify. |
| DE15998 | Custom sections in Case Detail page do not appear in the PDF Export. In addition, very large text entries in the Symptoms, Diagnosis, and Recommendation sections may overflow without a page break, such that text disappears at the bottom of a PDF page. Workaround: Users should add new lines (clicking Enter) to any previous sections or to reduce the length of any sections that are overflowing off the page. Note: Similar problems are encountered if long comments are entered in the Action sections. |
| DE16189 | If a user updates the Next Related tag as "Null" by Tag Patch, tag correlation is not removed from the tag correlation table and in the UI, the correlation still exists. |
| DE16292 | Via API, the category field is not validated as mandatory. If a group is created without a category, group associations will not be allowed. Workaround: Always create a group with the category field populated. |