AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.

    Skip to end of metadata
    Go to start of metadata

    You are viewing an old version of this page. View the current version.

    Compare with Current View Page History

    « Previous Version 208 Next »

    On this page:

    Your Rating:
    1 Star2 Star3 Star4 Star5 Star
    8 rates
    This topic covers release information for the AppDynamics App iQ Platform versions 4.5.x. In addition to the enhancements and resolved issues described here, the latest 4.5.x release includes enhancements and resolved issues included in certain limited-availability releases, as well as security fixes. 

    The first generally available 4.5.x release is 4.5.nnn, which incorporates fixes to pre-release issues in 4.5.nnn and 4.5.nnn.

    The release notes are inclusive. All updates since 4.5.nnn are noted in the 4.5.x Release Notes. The Product Announcements and Alerts page lists versions, along with release dates, across product versions. 

    This documentation reflects AppDynamics Application Intelligence Platform version 4.5.x. Changes between minor versions are noted in the release notes and indicated in-place in the documentation where applicable.   

    AppDynamics App iQ Platform Notes 

    The following updates apply to the common components of the AppDynamics App iQ Platform, including changes to the cross-product elements of the Controller UI. 


    Asynchronous Snapshot Viewer

    • The Waterfall View now displays asynchronous calls in addition to synchronous calls. The asynchronous calls are represented by dotted arrow lines, while the synchronous calls are represented by solid arrow lines.

    Audit Logging

    • Audit logging coverage has been made more comprehensive. It now includes the following:
      • Failed logins
      • Changes to configuration settings, e.g. health rules, policies, actions, etc.
      • 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.

    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, etc. See Data Collection Dashboard for more information.

    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 App iQ 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 back in Azure. 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.


    License Management

    • You can view the Service Availability (SAM) license graph on the Rules tab under License.
    • You can create license rules using the REST API.

    Resolved Issues


    ALERT-716Actions are now triggered even when “Execute Action on 100% of the Nodes” is configured
    ALERT-902Reporting of repetitive controller log files with identical content is now fixed
    ALERT-945Though 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-2067Cannot 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-2081REST 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-2159Status of the customised widget for a health rule remains unchanged in the dashboard although the health rule is disabled


    Application names under Roles are not in alphabetical order
    PLATUI-313Application search under Roles is case sensitive
    PLATUI-346Application search under Roles displays blank screen after scrolling
    PLATUI-736Unable to save the custom role when the dashboard search box is selected
    REPORTS-105Dashboard Health List names in Hebrew are not displayed on Reports on Linux Controllers

    Reports are not generated properly – includes empty iframe

    DASH-2721Event List changes are not reflected properly on the UI.
    DASH-2668Wildcard is not working for custom metrics type, Server|Component:<tier_id Or tier_name>.
    DASH-2665Health List widget fails for Server entities.
    DASH-2660War room template cannot be created with forward or back slashes in the template name.
    DASH-1276Inconsistent fetch depth is observed for Metric Tree Selector while handling custom visitors.
    DASH-1245Editing Metric Value Widget alters the existing metric title.
    DASH-1231Clicking Health rule in the health status widget displays a blank page.
    DASH-1198Support custom metrics type, Server:Component:<tier-name> in custom dashboards.
    DASH-1166After upgrading the Controller from 4.0 to dashboards are distorted.

    Known Issues

     Universal Agent

    • To use the Universal Agent to deploy the Analytics Agent on Linux, you must use machine-agent mode. Standalone mode is not supported for this use case.

    • Using the auto-Java feature for deployment of the Java Agent with the Universal Agent is not supported on Windows 2008 SP2 32-bit and 64-bit.
    • To install the .NET Agent with the Universal Agent use a local repository for the .NET Agent distribution file. Downloading the .NET Agent from the Controller is not supported.

    IBM WebSphere

    • For JMX functionality to work, set a Currently monitored statistic set to an option other than None in IBM WebSphere.

    Application Performance Management Notes



    Controller Enhancements

    • You can now drill down into federation applications. This allows you to display incoming calls from the upstream federated application.

    • A new Create Events permission has been created.
    • The waterfall view in the snapshot viewer has been enhanced to give improved navigation and analysis of Business Transaction with asynchronous implementations.

    App Agent Enhancements

    • Added new app agent node property queue-single-threaded. This property specifies the threading architecture for the IBM MQ message queue. The value defaults to "false."

    Java Agent Enhancements

    • Added a node property jmx-query-timeout-limit to override ignoring JMX rules/attributes.
    • The Java Agent supports transaction detection, naming, and data collector instrumentation for the IBM BPM product.
    • The Java Agent supports for Correlation for Kafka.
    • The Java Agent adds support for Eclipse Vert.x version 3.5.
    • The Java Agent adds support for Java Servlet API version 3.0.
    • The Java agent adds support for Log4j 2.
    • The Java Agent handles the Exit Point Identification of the Distributed Command Bus for Axon 3.x.
    • The Java Agent now reports Business Transaction and Backend timings reflecting the black-box http response times for supported asynchronous entries and exits.
    • The Java Agent now reports errors that occur on asynchronous threads.

    .NET Agent Enhancements

    • .NET Core for Linux SDK

    • .NET for Pivotal Cloud Foundry (PCF)
    • Added support for disableInjectFields in .NET Core applications
    • You can now include or exclude applications using the AppDynamicsConfig.json file
    • Universal C Runtime is no longer required for the .NET agent installation
    DOTNET-1351Machine snapshots do not show CPU percentage and process when ProcessNameFormat is set to 2.
    DOTNET-1319Agent is not able to identify the ADO.NET exit for the System.Data.Common.DbDataAdapter class methods.


    Upgrade Notes

    Resolved Issues

    DLNATIVE-1501PHP crashes when cleaning up cURL headers
    DLNATIVE-1520PHP crashes when trying to access PDO handle that does not exist in the registry
    DLNATIVE-1521PHP crashes when trying to destruct a CurlHandleInfo on curl_close
    DLNATIVE-1579PHP crashes when making a cURL request
    JAVA-3086Error creating custom JMX rules which are inside a composite data structure(array)
    JAVA-3088Limit error references held when agent not connected to Controller
    JAVA-3161StackOverflowError in CallGraphBuilder.fixChildrenWaitBlockTime(CallElement e)
    JAVA-3190NPE thrown when trying to get Destination type (JMS) and disabling interceptor
    JAVA-3214AppAgent 4.4.x version does not start with JDK 1.9 as JRE runtime version
    JAVA-3485WebSpherePMI Domain MBeans are not supporting instance identifier customization
    JAVA-3598NPE Error with VERTX API version 3.3.0 and java agent 4.4.1
    JAVA-3809Correlation not working for ning http client
    JAVA-3819Memory leak when adding EUM http header in NettyHttpResponse 
    JAVA-3846Enable EUM Correlation for Mule ESB in 4.4.x agent

    Known Issues

    • If you enable Kafka consumer entry points for the Java Agent, the flow map shows the data flow in reverse from the node to the Kafka cluster.
    • Business transaction retention settings are not affected by the business.transaction.retention.period value in the Admin Console.
    • For JMX functionality to work, set a Currently monitored statistic set to an option other than None in IBM WebSphere.


    Database Visibility Notes



    • Couchbase monitoring is now supported.
    • Custom metrics enhancement: you can specify a custom query that you want Database Visiblity to issue at regular intervals. The results are collected in a custom metric.
    • Parameter change tracking enhancement: you can view the changes to database configuration parameters over time.
    • Export collectors enhancement: you can export database collector data into a CSV file.
    • Snapshot correlation enhancement: you can view the queries that were issued by each business transaction.
    • Custom cluster support: you can define a single collector configuration to monitor multiple database instances that form a cluster or group e.g. a sharded architecture.

    Resolved Issues


    DBMON-2943Posgres Collector is unable to navigate to databases section from Object Browser
    DBMON-2953DB Agent 4.4.2 fails to start with SQL Server collector when Windows authentication is enabled
    DBMON-2977MSSQL Collector stops reporting data after 9 minutes

    End-User Monitoring Updates




    Browser RUM

    • SPA2 Monitoring now enables you to use the JavaScript API to manually report events. 
    • Browser RUM Analyze now displays request details in the Session Details dialog and has filters for viewing requests that have resource timing metrics or by the record types Page & Ajax Loads or Post-Load JavaScript Errors.

    Mobile RUM 

    • The new Code Issues Dashboard enables you to get trend and detailed information about caught non-fatal exceptions and instances of applications not responding (ANRs). The Android/iOS SDKs enable you to set the severity of caught non-fatal exceptions, so that you can filter code issues by severity in Code Issues Analyze.

    • Mobile RUM now provides monitoring support for hybrid applications. You can use Mobile RUM to monitor Cordova-based applications and the WebViews running in native iOS and Android applications. For iOS and Android native applications, the iOS and Android Agents inject the JavaScript Agent into Android WebViews and iOS UIWebViews to enable monitor and collect metrics from the WebViews. For Cordova-based applications, you install the AppDynamics Cordova plugin. See Hybrid Application Support for more information.

    IoT Monitoring

    The IoT REST API enables you to correlate business transactions between IoT applications and business apps. See Correlate Business Transactions for IoT Monitoring for more information. 

    Resolved Issues

    Browser RUM



    The JavaScript Agent component that monitors and reports Ajax events conflicts with zone.js


    The Controller is not receiving metrics because of a time skew between the Controller and the EUM Service


    Child Ajax events are not reported because of missing parent page events


    When an EUM app's new metric limits are reached, no new metrics are created, and data for existing metrics are not recorded


    The JavaScript Agent is freezing a single-page application when the application triggers a search event

    Mobile RUM




    For some iOS ANRs, the wrong thread is marked as not responding

    Browser Synthetic Monitoring




    The start time is incorrect for synthetic sessions where the HAR doesn't have a base page


    Some internal errors are being reported as timeouts

    EUM UI

    EUMUI-1703Mobile sessions are not loading for some users
    EUMUI-1574Regular expressions the include ampersands aren't working
    EUMUI-1033The map locations of US cities are incorrect when filtering by 'United States'
    EUMUI-616When a user has been explicitly granted delete permission, deleting a job shows an error box, although the deletion works
    EUMUI-608The screenshot timestamp for synthetic sessions should not be an available field

    Infrastructure Visibility Notes

    Important Note about Changes in Dynamic Monitoring from Previous Releases

    Starting in release 4.5, the default Dynamic Monitoring Mode (DMM) for all Standalone Machine Agents is KPI (collect Key Performance Indicator metrics only). This is true for the following metrics:

    This change can affect any user-defined features created in previous releases that rely on Diagnostic or Advanced Diagnostic metrics. Examples include Health Rules, Dashboards, and  scripts with metric API calls. AppDynamics strongly recommends that you disable these user-defined features or edit them to use KPI metrics instead. For more information about Dynamic Monitoring Mode, see:

    Standalone Machine Agent Enhancements

    • The Standalone Machine Agent is now supported on Windows Server 2016.

    Server Visibility Enhancements

    • This release supports monitoring of applications deployed in OpenShift v3.
    • Dynamic Monitoring Mode enhancements:
      • Dynamic Monitoring Mode (DMM) is now supported for all Docker Visibility metrics. See Dynamic Monitoring Mode and Docker Visibility.
        TBD – Move this page over to the Cloud Space when 4.5 goes GA
      • The Controller now has three different DMM defaults for all agents reporting to that Controller. Each setting applies to a different set of metrics. 
      • The default for all three settings is KPI, the lowest setting: collect Key Performance Indicator metrics only. 
      • AppDynamics recommends that you leave these global settings at their defaults and increase the DMM on individual servers or containers on an "as-needed" basis: 
        • When you need to troubleshoot a specific server or container, increase the DMM on that object only. 
        • When you finish troubleshooting that object, set the DMM on that object back to KPI.
        • This workflow is described in detail in TBD. Link to page in Cloud Space when 4.5 goes GA
      • When a container monitored by a Java App Agent shuts down and restarts, any overridden DMM specified for the shut-down container is lost. The DMM for the restarted container automatically resets to the global default specified by sim.machines.dmm.container.defaultMode.
    • Docker Visibility enhancements:
      • The Container Details window includes a new Network tab. This tab is available only if the Dynamic Monitoring Mode for the container is Diagnostic or Advanced Diagnostic. This tab shows:
        • Network KB – Total traffic (KB)
        • Network Rate – Rate of traffic (KB/s) 
        • Network Errors
          • Packet Drops – Rate of incoming/outgoing packets dropped by the network. A high rate of packet drops might indicate congestion or other network issues.
          • Errors – Rate of incoming/outgoing packets with errors. 
      • The following new metrics are available in the Metric Browser:
        • CPU %Busy Scaled – If the -cpus=<value> option is set in the container, this metric measures the scaled value of the CPUs property. If this value is not set, this metric measures the scaled value of the Logical CPUs property.
          You must enable CPU Scaling on the Controller to collect this metric. See Docker Container Metrics.

        • Network metrics
          • Incoming KB
          • Outgoing KB
          • Incoming KB/sec
          • Outgoing KB/sec
          • Incoming packets
          • Outgoing packets
          • Incoming packets dropped
          • Outgoing packets dropped
        • Disks – these metrics might not be available on all platforms:
          • Average IO Utilization (%)
          • Queue size

    Network Visibility Enhancements

    • Transaction Snapshots now support network analysis and troubleshooting workflows. 
      In the Snapshot Overview, you can right-click on a flow and choose View Network Metrics. The resulting dashboard shows the Performance Impacting Events (top-left chart) for that flow and possible correlating factors for these events. See KPI Metrics in Right-Click Dashboards.
    • The Network Dashboard can now show Cross Application Flows that use JMS entries or web servlets.
    • The Network Agent uses packet captures to calculate Network Visibility metrics. You can use the following new Health Rule to troubleshoot packet-capture issues that might affect metrics generated by an agent: 
      Network-Host: Packet drops too high
      This rule triggers an alert when packets get dropped between a Network Agent and the host interface. A high rate of packet drops on the host can result in inaccurate metrics.    
    • The Connection Explorer, Mapping Wizard, and Connections tab (in network link popups) can now display the Fully-Qualified Domain Names for remote services and Load Balancers. This makes it easier to identify the external services used by your monitored applications.
    • Usability enhancements:
      • Right-click dashboard charts now support both linear and logarithmic scales. Click in the top-right of each chart to change the scale to best highlight metric spikes and variations.
      • You can open the Unmapped Connection Wizard directly from a Tier Dashboard if that tier has any unmapped connections.
    • The Network Dashboard uses a new visual convention to represent TCP Endpoints.

      TCP Endpoint in 4.4
      TCP Endpoint in 4.5

    Resolved Issues



    Machine Agent cannot collect OS info on Red Hat Extended Linux 7.4


    Service Availability Event should display events related to that service only


    Node Dashboard > Server tab should show the same information as Server Dashboard


    Enabling sim.machines.reuse.enabled sometimes results in thread pool saturation and prevents Standalone Machine Agent from communicating with Controller


    Server page shows data for 13 hours, not selected time range of 1 day (observed on SaaS Controller)


    In some cases, Machine Agent stops collecting process metrics even after machine/global max thresholds are increased


    Machine agent is not reporting processes, network and volumes when running in Container


    Disk usage percentage on Linux needs to reflect "df -P -m" command


    Machine Agent not reporting metrics on docker when process command contains space


    Hierarchy name check is case-sensitive, which prevents Standalone Machine Agent registration


    Number of CPUs reported by Standalone Machine Agent is sometimes in accurate on Windows


    Cannot update RPM Standalone Machine Agent due to packaging error


    License > Account Usage does not show Service Availability license usage


    Known Issues

    Standalone Machine Agent Known Issues

    • Reset Machine Agent action on the AppDynamics Agents window is not available for 4.4 and higher Machine Agents.
    • (Windows only) The JavaHardwareMonitor extension and the ServerMonitoring extension (introduced in 4.2) assign network names differently. If you have any health rules based on JavaHardwareMonitor names, and you want to use these rules with the ServerMonitoring extension, you will need to update the names that these rules are based on.

    Server Visibility Known Issues

    • If a metric name contains colons or pipe characters (: or |), the Metric Browser interprets the name as hierarchically separated. These characters could appear in a process name, a disk or partition name, a mount point, or a network interface name. TBD METADATA-1373
    • If the machine that a Machine Agent is monitoring goes to sleep, monitored processes might be duplicated on the Controller. Because the process has a new start time, the Controller interprets it a new process. When the configured process count is reached, the Controller marks the duplicated processes as terminated and purges them.
    • (Windows only) You must have .NET Compatibilty Mode enabled for Server Visibility to work correctly on a server with a .NET APM agent installed.
    • Server Visibility does not support the following on Solaris:
      • Solaris zones
      • Unicode characters
    • The following Health Rule is disabled by default in this release: 
           Disk Usage is too high on at least one partition. 
      This wildcard health rule can result in high resource consumption and health rule evaluation times on the Controller. If this rule is critical for your environment, the recommended practice is to create your own custom Health Rules and apply specific rules for specific volumes on specific servers. For more information, see the following Support Advisory:

    Docker Visibility Known Issues

    • The Standalone Machine Agent running inside the container sometimes reports a few extra volumes for the host machine. This can result in a higher total volume for the aggregate volume metrics.
    • There might be gaps in the container network I/O metrics. This happens because the Docker API resets the accumulated network I/O metric data for every 4.2 GB of data sent or received. When the data is reset, the Standalone Machine Agent calculates negative I/O values and does not report a data point for that time window.
    • If the agent started monitoring the current container after the beginning of the selected time range in the Controller, the Controller might show metric data prior to the container start time. This metric data will include metrics from a previously monitored container. This behavior occurs when the Controller flag "sim.machines.reuse.enabled" is enabled. 
    • If the agent started monitoring the current container before the beginning of the selected time range in the Controller, the data is correct for the current container.
    • If a container stops running while it is being monitored, the Tiers & Nodes Dashboard > Server tab will show data for the stopped container rather than for the underlying server.
    • In some cases, container monitoring is suspended when some containers that are currently being monitored are stopped. This issue has been observed on Docker API version 1.24. The suggested workarounds, in this case, are to
      • Restart the Standalone Machine Agent (Docker Visibility will start monitoring the containers), or 
      • Upgrade to Docker CC/EE v17.03 or Docker Engine v1.13.
    • TBD DOCS-2070 cgroup data collection is not supported in Kubernetes deployments. If the Standalone Machine Agent is monitoring containers deployed as Kubernetes pods, do not enable the cgroup Enabled setting.
    • The Container Details > Network tab does not display IP or MAC addresses for monitored containers.


    Network Visibility Known Issues

    • In the Application Flow Map, you can click on a flow and view a Network tab in the flow popup. The Network KPIs shown (Latency, PIE, Errors) are based only on the exit traffic from the initiating service on that flow. To view Network KPIs for all monitored traffic to and from that service, go to the Network Dashboard and open the popup for a network link.
    • If you open the Network Flow Map for an individual node, the KPI metrics for node-to-load-balancer and node-to-tcp-endpoint links show network KPIs for all nodes in the parent tier (instead of KPIs for the individual node only). To view KPIs for the individual node, open the link popup and look at the Connection KPIs. 
    • Network Visibility cannot monitor cross application flows that use Jersey web servlets. To monitor these flows in Network Visibility, you must disable Jersey servlet instrumentation:
      1. Select the application of interest in the Controller UI.
      2. Choose Configuration > Instrumentation > Transaction Detection.
      3. Disable instrumentation for Jersey Servlet and Jersey 2.x Servlet.


    AppDynamics Business iQ Notes

    Enhancements and Updates

    ADQL and Widgets Enhancements (DRAFT)

    • User experience of running ADQL queries has been improved:
      • ADQL UI now has the Save button. Use the button to save new searches.
      • The following fields are added to the ADQL UI for mobile_snapshots: Platform, Request Content Length, Response Content Length, Country, Region, Background.
      • The Analytics Search page shows advanced statistics, such as standard deviation, median, minimum, and maximum, for numeric fields. Click the field to view associated statistics.
    • The following clauses are added to ADQL: HAVING and SINCE ..UNTIL.
    • The analytics functions, such as avg, max, and min, now support the datetime format.
    • Business iQ now supports exporting data to a file in CSV format for external use. Use the Search page to do so.
    • Type conversion for MIDC and HTTP Data Collectors are supported in Transaction Analytics. The MIDC and HTTP Data Collectors allow you to convert transaction analytics data into suitable data types. The supported data types are String, Boolean, and Number.
    • ADQL now supports the TotalResults() function. It returns the total count of events. TotalResults() does not accept a field.
    • The IS NOT NULL operator is now supported in Basic mode (Drag and Drop Search), including Funnel filters. The operator returns all the events with values either true or false.
    • The numeric widget now has a comparison indicator. Use the Compare to and Trailing By options in the Widget Properties to indicate an offset. The Compare to option by default is set to None. Select Prev.period from the Compare to drop-down and specify the relative time in minutes, hours, or days using the Trailing By option. The current aggregate value is compared against the period you specify and the difference is displayed on the widget.
    • All the widgets now support user input for percentile aggregations. The supported values are integers between 1 and 99 inclusive. In Basic mode, drag a numeric field to the canvas, and use the drop-down next to the field name to specify a value for percentile aggregation.
    • The logarithmic scale is now supported in Analytics widgets for the Time Series charts. Use the Logarithmic Y Axis checkbox in the Widget Properties to apply the logarithmic scale to a selected field.
    • Ability to hide legends is now supported in widgets. In the Widget Properties, select None from the Legend drop-down to hide legends.
    • Analytics Widget Properties now have an option to make the widget's background transparent.
    • Agent ID and Client GUID are exposed in the Data tab and can be used to build custom widgets.
    • Close Widget Builder option is provided to support canceling widget editing. With this option, unwanted changes to a widget can be dropped while editing, and revert to the previous version by closing the widget.
    • The extra whitespace on the histogram has been removed. The histogram now looks condensed on the dashboard.
    • The metrics created using the Numeric widget now displays the exact value returned by the search. In Widget Properties, select Exact from the Format drop-down to view the exact number. Other options available are Automatic, Thousands(k), and Millions(m). The default is Millions(m).
    • You can now edit the properties of multiple widgets. See Create and Manage Custom Dashboards and Templates.

    Business Journeys

    • Business Journeys authoring has been enhanced with the following features:
      • Business Outcomes has been renamed as Business Journeys.
      • A Search button has been added to the Business Journey page. Analytics Search button provides one-click access to the underlying events. Selecting an enabled Business Journey and clicking Analytics Search takes you directly to the Searches page in Basic mode. Analytics Search button is unavailable for definitions in Draft and Valid Draft states.
      • Float type is supported for filtering Business Journey events.
      • Custom event types are supported.
      • Custom event data can be used to create Business Journeys.
      • All the fields that are part of filters and optional filters are automatically collected.
      • When defining Business Journeys, you can now delete the same field from one milestone and add it to a different milestone in the same Save action.
      • At the Business Journey level, a field named completed has been added to track the status of the workflow using the boolean values. True represents a completed Business Journey, whereas False indicates that the journey is in progress or is incomplete. Use the Search widget or an ADQL query for the desired Business Journey with the query string completed to view the status of the associated events.
      • As you create milestones, a flow map detailing the business workflow is now displayed in the Business Journey page. Additionally, selecting a Business Journey opens it in a new window with the flow map enabled. This behavior is controlled by the property in the Controller Settings.

    Business Metrics

    • Enabling and disabling Business metrics are supported. Use the Enable and Disable button on the toolbar to do so.
    • Double-clicking a Business metric opens it in the Metric Browser.
    • Business Metrics list is now searchable.
    • Event Type column is added to the Metrics page.
    • Metric on ratios is supported.

    Experience Level Management (XLM)

    • Visibility into XLM data is improved in the following ways:
      • You can now create XLM dashboards and reports in the time zone of your choice.
      • You can now export reports. Reports are exported in CSV format, and contain however many reporting periods you choose.
    • You can now migrate XLM configurations from one environment to another. One common use case is when you first deploy a configuration in a staging or test environment and then need to migrate it to production.

      This is done by making two API calls.

      1. Export XLM configuration(s) from one environment.

        GET /controller/analytics/xlm/configuration

        Optionally, supply a configuration ID, or a comma-delimited list of configuration IDs, as a query parameter.

        If this parameter is omitted, the API returns a bulk export of all XLM configurations.

      2. Import a single XLM configuration into another environment.

        POST /controller/analytics/xlm/configuration

    Log Analytics

    • You can now specify files to exclude from ingestion, by defining a glob pattern of file paths to blacklist.
      • Here is a common two-step use case:
        1. Define a glob pattern to include all the files that you want to ingest
        2. Define an additional glob pattern to exclude (blacklist) files that satisfy the first glob pattern, but that you do not want to ingest 

    Upgrade Notes

    Upgrading the Analytics Agent

    If you are running the Analytics Agent as a standalone binary, see this topic: Upgrade Analytics Agent.

    If you are running the Analytics Agent through the Standalone Machine Agent, See Upgrade the Standalone Machine Agent for instructions. 

    If you have been collecting log analytics data:

    1. Preserve the old watermark file so that you can copy it to the corresponding location in the new <analytics-agent-home> directory structure.
    2. Preserve your pre-existing job files so that you can copy them to the corresponding location in the new <analytics-agent-home> directory structure.

    Field Names for Data Collectors

    In versions prior to 4.3, Analytics used the actual HTTP parameter name to display the fields collected by Data Collectors. Beginning in 4.3, Analytics is using the configured display name for such fields.

    When you upgrade to agents versions 4.3 or above, new HTTP parameter data will appear under the display name. If you had previously configured the display name to be different from the actual parameter name, your historical data and new data collected by the 4.3 or 4.4 agents for a single HTTP parameter will be split between the two field names.

    Enabling Transaction Analytics

    Beginning with 4.3 agents, you should enable Transaction Analytics exclusively using the Analytics Configuration UI. The Analytics Configuration UI allows for enabling Analytics at the Application level. You should no longer use the deprecated analytics-dynamic-service-enabled node property. 

    If you change the analytics-dynamic-service-enabled node property through the Agent Configuration UI (updating the analytics-dynamic-service-enabled node property directly) it will have no effect on version 4.3 or higher Java Agents.
    Related Background

    Version 4.2 and earlier app server agents use the analytics-dynamic-service-enabled node property to enable Transaction Analytics. Using the node property directly allowed for disabling and enabling the Analytics Dynamic Service at the application, tier, and node levels. The Analytics Configuration UI allows for setting this property only at the Application level. Therefore, Java Agents 4.3 and higher are not able to disable or enable the Analytics Dynamic Service at the tier and node levels.

    Although the Analytics Dynamic Service configurations can be directly changed through the application import and the Analytics Dynamic Service import REST API, manipulating the Analytics Dynamic Service configurations through either of those mechanisms only updates the Analytics Dynamic Service configurations and not the corresponding analytics-dynamic-service-enabled property. Therefore, if you use one of these import mechanisms to enable or disable the Analytics Dynamic Service and you have a mixture of old (pre 4.3) and new (4.3 and higher) agents, you must manually set the associated analytics-dynamic-service-enabled property to match the Analytics Dynamic Service configuration value. The analytics-dynamic-service-enabled node property can also be set as part of the Application Import and has its own Import REST API (accessed at POST /setAgentProperty). See "Import Application Analytics Dynamic Service Configuration" at Configuration Import and Export API.

    Resolved Issues

    ANALYTICS-4119Some unique identifiers of Funnel Widget are not exposed in the Event table in the Analytics Data tab
    ANALYTICS-4534UI sometimes incorrectly shows "unhealthy" as status for Analytics Agent


    Users assigned Analytics Administrator permissions through a Group cannot see searches saved by other users
    ANALYTICS-4806Analytics Agent stops ingesting logs when log file rolls over
    ANALYTICS-7554Duration settings for XLM synthetic sessions are in seconds, but should be in milliseconds

    Known Issues

    • Metrics created from aggregations on eventTimestamp do not work as expected.
    • To deploy the Analytics Agent on Linux using the Universal Agent, you must use machine-agent mode.
    • (Windows only) You can not delete a log file with the "del" command while the Analytics Agent is collecting log data from the file.
    • For Analytics Searches: 
      • In Basic mode, regular expressions and the NOT logical operator are not supported for free text search. 
      • In Basic mode, quotes and commas have no special meaning.
      • Saved Searches from 4.1 can be imported multiple times if you click 'Import from 4.1' button multiple times.
    • Due to timing issues, full information on business transactions might not appear immediately after running a Transaction Analytics search.
    • If you have deployed EUM such that you are using an on-premises Events Service for transaction and log analytics data, and the SaaS Events Service for your EUM data, you can not query the browser or mobile request data using the Analytics API.

    AppDynamics On-Premises Platform Notes

    The following notes describe updates to the AppDynamics on-premises platform, including the Controller, Events Service, and EUM Server components. 


    Enterprise Console

    • There is support for major-version upgrades for the Enterprise Console application. You can select which version you would like to upgrade to.

    • The Enterprise Console installer now uses version 6 of i4j. This resolves issues with warnings seen when installing on console mode.

    • The JRE of the Controller and Events Service has been upgraded to version 8u162.

    • You can now upload your license using the Enterprise Console UI.

    • When adding the Enterprise Console host machine, you should stop using the alias, 'platformadmin', and instead start using the following:

      • On the CLI, you should use 'localhost', the loopback address '', or the machine's actual hostname.
      • From the UI, you should use the Add Enterprise Console Host button, which will automatically populate the text field with the hostname of the Enterprise Console machine.
    • You can edit credentials from Custom Installation.
    • You can download logs for a failed job from the Enterprise Console Jobs page.
    • You can manage your Controller SSL certificate on the Enterprise Console UI under Configurations.
    • The Enterprise Console CLI commands now consistently use hyphens (-) instead of underscores (_).

    • The Enterprise Console supports up to 20 platforms at a time by default. You can configure this setting in the PlatformAdminApplication.yml file.

    Resolved Issues


    ECONSOLE-1529Windows Controller installation fails when special characters are used in controller admin password
    ECONSOLE-1923Enterprise Console UI does not show where to upgrade an existing Controller
    ECONSOLE-1924Enterprise Console upgrade procedure shows Install instead of Upgrade at the bottom
    ECONSOLE-1951Service name is not displayed in the error message when the Windows service registration fails
    ECONSOLE-1978Enterprise Console startup script should unset CDPATH
    ECONSOLE-1992Enterprise Console does not back up configuration files when any configuration is updated
    ECONSOLE-2068Internal app agent does not report to internal monitoring Controller automatically after Controller installation on Windows
    ECONSOLE-2087Enterprise Console should check available disk space before taking controller backup
    ECONSOLE-2563Verify SSH connection fails due to incorrect SSH setup
    ECONSOLE-2608Upgrading MySQL task does not update the database version correctly if the job fails halfway
    ECONSOLE-2656Enterprise Console fails on SuSE

    Enable edit of platform path within Enterprise Console UI

    ECONSOLE-2712orcha-modules.log contains no dates
    ECONSOLE-2796Misleading Enterprise Console error message in platform-admin-server.log - attempted to reach unknown host
    ECONSOLE-2806db/lib backup does not cope well with Linux symbolic links
    ECONSOLE-2851Add current Linux effective user name to rsync/ssh UI error messages
    ECONSOLE-2936Intermittent HA primary Glassfish availability leads to two active controllers running
    ECONSOLE-2938Glassfish server.log file size reduced by 60%
    ECONSOLE-3220Secondary MySQL does not start due to space ID collisions
    ECONSOLE-3238Failover Job does not trigger

    Controller stop operation fails when service is in STOP_PENDING

    METADATA-1843User login exception when using old password format
    METADATA-2198Description of audit.log.file.size property in admin.jsp does not mention units
    METADATA-3606Controller startup failure due to login audit failure in 4.4.1
    METADATA-4242Upgrade fails if dropping mds database fails in execute setup.xml ant tasks

    Known Issues

    • Controller audit reports do not work immediately after upgrading the controller to 4.5. Audit table migration messages are logged in the server.log file when audit reports are run before completing the audit database table migration process. Try running the audit reports again at least an hour after the upgrade.

    Deprecation and End of Life (EOL) Notices

    • The AppDynamics Java Agent will no longer support monitoring Java applications running in the Java Development Kit 5. See Desupport Notice: Java Development Kit 5.
    • Mobile RUM: Dynamic Info Points are no longer available for Android apps.

    • End-User Monitoring: The option View Dark Mode has been removed from the Geo Dashboard.

    • Server Visibility (formerly Server Monitoring): The "Disk Usage is too high on at least one partition" health rule is now disabled. See Support Advisory: "Disk Usage is Too High" Health Rule is Disabled in Release 4.3 and Higher.
    • The Controller UI is no longer supported on IE 9. IE users are advised to use IE 10+ versions when using the Controller UI.
    • The Controller Package Installer is no longer supported. The Enterprise Console application supports most of your platform deployment needs, including installing a Controller and Events Service.
    • No labels