The following notes describe 4.5.x updates to the common components of the AppDynamics Application Performance Management (APM) Platform, including changes to the cross-product elements of the Controller UI.
If an artifact has been updated, the version number of the updated artifact and its availability date are listed below. The version number corresponds to that shown on the download portal (http://download.appdynamics.com).
The most recent releases appear at the top of the page.
For updates to the Universal Agent, see the following page:
4.5.10 Updates
The software for this update is available to SaaS-only customers at this time. For those on-premises customers considering upgrading to the latest version, the following describes what has been fixed in the next release.
Version 4.5.10
Enhancements
- The Tiers & Nodes dashboard by default only shows the tiers and nodes that receiving performance data for the selected timeframe. You can use a filter to view tiers and nodes receiving performance data, not receiving performance data, or all tiers and nodes.
- The Metric Browser also only shows by default the nodes for business applications that are receiving performance data for the selected timeframe. You can also use a filter to view nodes receiving performance data, nodes not receiving performance data, or all nodes.
- AppDynamics enables the monitoring of all containers on the host machine through the sim.docker.monitorAPMContainersOnly property. By default, only containers with APM agents running inside are monitored but this behavior can be changed by setting this property to false.
- You can now set permissions for the Analytics API Key on Connected Devices.
Resolved Issues
Key | Summary |
---|---|
APMPLAT-8298 | File "UnresolvedBackendCallInfoDao.jar" performs unsafe sort methods |
APMPLAT-11095 | Clicking the “View Dashboard During Health Rule Violation” link from "Health Rule Violation" dialog opens the Server Visibility UI |
APMPLAT-11341 | "View Dashboard" link from "Health Rule Violation" page is loading a different application dashboard |
ANALYTICS-9588 | Exporting Analytics Report as .csv not working on Windows machine |
ANALYTICS-11210 | Metrics on custom events stopped populating |
DOTNET-3596 | SSRS crash due to agent-bootstrap-instrumentations with microservices agent |
DBMON-4767 | Search in Database Agents tab should be case-insensitive |
EUMIOT-1337 | EUM metrics in the Controller did not refresh its application info cache after the EUM account changed in the Controller |
SERVER-5153 | View Dashboard During SIM health Violation should go to correct Server page |
SERVER-5549 | Http proxy auth fixes - logging & toggle to prevent basic auth header removal |
SERVER-6273 | Regression in TaggedMetricsConstants |
UIPLATF-5506 | Time range selector is not available on sharing dashboard |
UIPLATF-6395 | Graphs in the Memory tab do not display the correct time range as per selected custom timeframes |
UIPLATF-6598 | Selected server is not displayed for single metric selection on the configuration screen |
Known Issues
There can be a short delay before non-APM containers are monitored when upgrading to the 4.5.10 Machine Agent. This happens where the user sets the sim.docker.monitorAPMContainersOnly
property to enable monitoring of non-APM containers but also has sim.docker.infraMode.enabled
set to true. In this case, non-APM containers won't be monitored until on-line schema migration happens. This takes approximately 4.5 hours after the Controller starts up.
4.5.9 Updates
April 22, 2019
Resolved Issues
Key | Summary |
---|---|
ALERT-2760 | Health Rule Affected Entities created using Flex may not be displayed in an HTML screen |
ALERT-2998 | When you edit an Action Suppression for nodes and tiers, Object Scope screen is blank |
ALERT-3103 | Actions get triggered though action suppression period is on |
ALERT-3109 | NullPointerException occurs and health rules continue to be evaluated even after the cron schedule for the health rule ends |
APMPLAT-9652 | Not able to edit Thread Dump Collection Interval |
APMPLAT-11002 | Node.js process snapshot screen in HTML5 lost a button |
APMPLAT-10115 | Setting PHP MVC custom match rules in the Controller UI results in exceptions when the backend creates the rule for the agent AND custom STRUTS rule (Java) to use |
Clicking "Node Dashboard > Grid view > Node" results in the error "Invalid unresolved backend call id :xxx" | |
APMPLAT-10452 | Information Point created from Snapshot drill down has blank class and method names |
APMPLAT-11026 | Exception occurs while creating or editing a PHP MVC custom match rule in Java |
Creating PHP MVC custom match rule causes failed configuration and no data | |
PLATCPS-10858 | (4.5.7) Database health rules not evaluating with external user who has roles Account Owner(default) and Administrator (default) |
UIPLATF-6049 | Selected color is not displayed consistently by stacked column on account |
UIPLATF-5898 | .NET node memory HTML screen displays incorrect data unlike the old flex screen |
UIADMIN-1323 | Unable to see compare releases functionality at the node level |
L4A-4700 | Database HRs not evaluating when configured for an INTERNAL user under a SAML account |
Deprecation Notices
- In the Scopes configuration screen of the Controller UI, the columns "Created by" and "Last modified by" have been removed.
- Once the Controller is upgraded to version 4.5.9, the Compare Releases functionality/feature will no longer be available in the Controller UI.
- Once the Controller is upgraded to version 4.5.9, the Flex screens functionality/feature will no longer be available in the Controller UI.
4.5.8 Updates
March 25, 2019
Enhancements
- The medium-sized Controller has been certified to run on Amazon Web Services (AWS) with Aurora database support. See Controller System Requirements
- Anomaly detection and root cause analysis, powered by the Cognition Engine, is now generally available for all SaaS customers.
- The pipe '|' or colon ':' can now be used interchangeably for the metric selection to work. See Using Wildcards in Metric Definitions
Resolved Issues
Key | Summary |
---|---|
PLATCPS-10096 | Unnecessary debug logging creates large log volume that affects license usage |
METADATA-5774 | NPE when loading ADD by bogus Id |
ALERT-3030 | Some health rules are not evaluated if ‘HealthRuleMetricDataCache’ limit is reached |
ALERT-2991 | Health rules are not evaluated if wild cards are used to define custom metrics in a relative path |
ALERT-3078 | Health rule incorrectly marks entities as violations due to isMetricTooNew() check |
UIPLATF-1679 | Unable to view list of events on clicking Events Viewer tab under shared dashboard URL. |
Deprecation and End of Life (EOL) Notices
As part of the Flex2HTML effort, we are deprecating On-Demand Reports. You can create reports similar to On-Demand in a few ways:
- Create a custom dashboard that displays the data you would normally receive from On-Demand reports. Next, set the report delivery, either one-time or at regular intervals, in Scheduled Reports.
- If your deployment is on-premises, you can defer the controller update to continue using On-Demand reports.
4.5.7 Updates
February 25, 2019
Resolved Issues
Key | Summary |
---|---|
DOTNET-3544 | Unable to import the .NET Agent configuration in the Controller |
METADATA-5729 | Metric tree event handler should be before health rule event handlers |
METADATA-5813 | NPE when loading ADD by ID |
PLATCPS-9634 | License usage for account is showing 0% when using time range larger than one day |
UIPLATF-5895 | .Net nodes display Flex Java page instead of .Net memory metrics page |
ALERT-2991 | Health rules are not evaluated if wild cards are used to define custom metrics in a relative path |
ALERT-3059 | Event reactor cache refresh time is severely affected when Action suppression windows are configured |
4.5.6 Updates
February 2019
Resolved Issues
Key | Summary |
---|---|
ALERT-2805 | ‘500 Internal Server Error’ is displayed sometimes, when viewing the health rule violation from application flow-map |
ALERT-2803 | False health rule violation events are triggered for ‘no data’ although data is available, when a health rule is re-enabled |
ALERT-2798 | Alerts triggered are missing event details and text ‘${event.eventMessage}’ is displayed instead, post controller upgrade to 4.5.4 |
ALERT-2787 | Health rules list truncates description when a REST API is used to list health rule violations |
ALERT-2727 | Discrepancy in the health rule type reported by the controller UI and SNMP alert |
ALERT-2806 | Health rule evaluates historical nodes as well, although ‘All nodes in the application’ filter is set |
ALERT-2832 | Health rule cache is not updated if metrics are purged directly without deleting entities, resulting in exceptions during evaluation |
ALERT-2871 | Some health rules are not evaluated after they are updated and saved |
METADATA-5554 | ADD::doToDto in Metric browser causes slowness and thread pool saturation |
UIADMIN-1397 | License rule to allocate at least one machine agent license for every APM unit is not mandated now |
UIADMIN-1398 | Administration > Roles window displays empty grids |
UIADMIN-1416 | LDAP users are not displayed when paging is disabled and the number of users exceed 1000 |
UIPLATF-5895 | .Net nodes display Flex Java page instead of .Net memory metrics page |
4.5.5 Updates
December 21, 2018
Resolved Issues
Key | Summary |
---|---|
ALERT-2627 | The ‘To’, ‘BCC’ and ‘CC’ email lists are not populated with email addresses when you import custom email actions using REST API |
PLATCPS-9298 | Remove max limit and expiry of security provider cache |
UIPLATF-2900 | Updating the metric is not working on the custom dashboard |
4.5.4 Updates
November 19, 2018
Resolved Issues
Key | Summary |
---|---|
ALERT-2605 | The "Health Rules / Problems API" returns the incorrect Controller URL |
UIPLATF-2900 | Updating the metric is not working on the custom dashboard |
UIPLATF-4893 | Grids are not showing up in the UI (ad-grid) |
UIADMIN-1376 | Node Memory Heap Flex page crashes on secondary account is causing later Flex routes to fail |
UIADMIN-1238 | Unable to view exception details for more than one day |
4.5.2 Updates
October 15, 2018
Resolved Issues
Key | Summary |
---|---|
PLATCPS-1423 | License usage REST API returns empty set |
Known Issues
LDAP users are not displayed when paging is disabled and the number of users exceeds 1000.
Workaround:
- Enable paging with LDAP and set the number of records returned from LDAP query to less than 1000.
- Manage LDAP user permissions through groups.
4.5.1 Updates
September 5, 2018
Resolved Issues
Key | Summary |
---|---|
ALERT‑649 | Controller does not detect service endpoints that are created after the health rule set to affect all the service endpoints is created |
PLATCPS-6578 | DB agent and Machine Agent 4.5 are unable to register with 4.5 controller (SaaS only) |
PLATUI-1168 | Database RBAC in Roles does not work in 4.5 RC |
Known Issues
- Flash issues have become more prevalent in 4.5.1 and onwards. All customers that use the latest version of Chrome are affected, regardless of the Controller version. See How do I install Flash in Chrome? for more information on how to enable Flash-based features.
As a best practice, AdBlock should be disabled when using the Controller UI. See How do I disable AdBlock in Chrome? for more information on how to do so.
4.5.0 Updates
July 11, 2018
Enhancements
Application Performance Management
.NET Core for Linux SDK
The .NET Core for Linux SDK lets you monitor the performance of .NET Core applications running on Linux.
The SDK supports the following:
- Business Transaction registration and error reporting
- Exit call with correlation and error reporting
- Metrics
- Snapshots with user properties but without callgraphs
Audit Logging
- Audit logging coverage has been made more comprehensive. It now includes the following:
- Failedlogins
- Changes to configuration settings, for example, health rules, policies, actions, and so on.
- Application deletion
- Audit log, report, and API details have been enhanced to include more information about what was updated.
- Audit Reports:
- You can use include/exclude filters in scheduled audit reports and rest API.
- There is also support for JSON and CSV formats for audit reports.
- You can enable or disable persistence of audit log state-change data using audit.log.changes.persisted flag in the admin.jsp file.
Data Collection Dashboard
You can view the current state of all configuration parameters that may affect your security and privacy from a single dashboard view. These settings include retention settings, custom data collectors, IP-address retention in EUM, and so on. See Data Collection Dashboard for more information.
Custom Dashboard Viewer permissions
- A custom dashboard viewer can view all data that the dashboard owner is permitted to view on the controller-level custom dashboards, regardless of application-level or other restrictions applied on the dashboard data.
Data Privacy Policy Dialog
AppDynamics provides a data privacy policy reminder, in the form of a UI dialog, when you or your users configure parts of the AppDynamics products that could be used to collect regulated or other protected information.
This customizable statement is present in all areas of the AppDynamics UI where data collection can be configured.
User Management
- Authentication and authorization security enhancements have been made to the AppDynamics APM Platform in the form of scalable, securable, and admin configurable support:
- You can create and use API Clients to provide secure access to the Controller through REST API calls. These calls now use OAuth token-based authentication over basic authentication. See API Clients for more information.
- The SAML authentication can handle encrypted SAML responses from identity providers. You can enable SAML Encryption on Authentication Provider of Administration on your Controller.
- When creating usernames in SAML in Azure environments, the UserName attribute is used if it is passed along. The NameID attribute is not handled if it is passed backinAzure. If you relied on the legacy behavior of concatenating the first name and surname, then you can work around this enhancement by changing your Azure provider to return the concatenated names in the UserName attribute.
UI
The UI for configuring health rules and policies has been redesigned to create a cleaner look and make it more intuitive. For more information, see, Configure Policies, Configure Health Rules, Health Rules, and Mobile Health Rules.
License Management
- License rules are now supported for Service Availability Monitoring (SAM). You can view the SAM license graph on the Rules tab under License.
- You can create license rules using the REST API.
Resolved Issues
Key | Summary |
---|---|
ALERT‑716 | Actions are now triggered even when “Execute Action on 100% of the Nodes” is configured |
ALERT-902 | Reporting of repetitive controller log files with identical content is now fixed |
ALERT-945 | Though the ‘action suppression’ configured with ‘Disable Agent Reporting’ is deleted, the associated agents do not report metrics until the configured action suppression time has elapsed |
ALERT-2067 | Cannot create health rules using synthetic job availability metrics or retrieve metrics for synthetic jobs older than a day if ‘EUM LITE’ license is used |
ALERT-2081 | REST API fails with a ‘500 error code’ if ‘CUSTOM_ACTION_STARTED’ event type is present in the returned events list and if the time duration set is greater than 120 mins |
ALERT-2159 | Status of the customized widget for a health rule remains unchanged in the dashboard although the health rule is disabled |
PLATUI-307 | Application names under Roles are not in alphabetical order |
PLATUI-313 | Application search under Roles is case sensitive |
PLATUI-346 | Application search under Roles displays blank screen after scrolling |
PLATUI-736 | Unable to save the custom role when the dashboard search box is selected |
REPORTS‑105 | Dashboard Health List names in Hebrew are not displayed on Reports on Linux Controllers |
REPORTS-152 | Reports are not generated properly – includesemptyiframe |
DASH-2721 | Event List changes are not reflected properly on the UI. |
DASH-2668 | Wildcard is not working for custom metrics type, Server|Component:<tier_id Or tier_name>. |
DASH-2665 | Health List widget fails for Server entities. |
DASH-2660 | War room template cannot be created withforwardorback slashesin the template name. |
DASH-1276 | Inconsistent fetch depth is observed for Metric Tree Selector while handling custom visitors. |
DASH-1245 | Editing Metric Value Widget alters the existing metric title. |
DASH-1231 | Clicking Health rule in the health status widget displays a blank page. |
DASH-1198 | Support custom metrics type, Server:Component:<tier-name> in custom dashboards. |
DASH-1166 | After upgrading the Controller from 4.0 to 4.3.3.3 dashboards are distorted. |
PLATCPS-1624 | Issue with username creation in SAML |
PLATCPS‑3096 | Snapshot information is doubled after archive operation |
PLATCPS-3968 | AWS 5.5MM /controller/restui/snapshot/getRequestSegmentData takes 44 seconds |
PLATCPS-5591 | Off-by-one error on license availability check for APM Any Language License |
Known Issues
- 4.5 SAML login requests fail post upgrade due to ADFS IdP. See Support Advisory: 4.5 SAML login requests fail post upgrade.
IBM WebSphere
- For JMX functionality to work, set a Currently monitored statistic set to an option other than None in IBM WebSphere.