PDFs

On this page:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
78 rates
This topic covers release information for the AppDynamics App iQ Platform versions 4.4.x. In addition to the enhancements and resolved issues described here, the latest 4.4.x release includes enhancements and resolved issues included in certain limited-availability releases, as well as security fixes. 

The first generally available 4.4.x release is 4.4.0.3, which incorporates fixes to pre-release issues in 4.4.0.1 and 4.4.0.2.

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

The 4.4.x documentation reflects AppDynamics Application Intelligence Platform version 4.4.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. 

Enhancements

Simple Search

  • You can now find a tier, node, application, or business transaction by simply clicking the find button on the top of the Controller UI and entering the first few letters of the entity name. Once you have found the entity of interest, you can click it in the list of matching items in the search box to open the flow map for that entity.
    Note the following:
    • The feature supports global search, not contextual search, so it is not limited to one application.
    • The feature does not perform strict contains search. The searched entity is broken down into tokens, and Simple Search supports a “stats with” search within each token.
    • Searches are not case sensitive.
    • You need to have Events Service installed for Simple Search to work since data and indexes are created and stored in it.

Custom Dashboard

  • The look and feel of dashboards has been simplified and improved, especially for the Heap & Garbage Collection dashboard found under the Memory tab of Tiers & Nodes.
  • The Health List widget has been merged with the Health Status widget since both supported similar concepts. The functionality of the new Health Status widget is the same as the old one but with a few improvements. The Health Status widget can support bar, list, and status light circle visuals. The circle supports multiple health rule evaluations, and now has different aggregation displays. Old, existing Health List and Health Status widgets are converted to the new Health Status widget upon upgrade. For more information, see Widgets.

  • You now have more control on how you would like your metric values to be displayed. In the Metric Value widget, you can specify the formatting of metric numbers by abbreviating them, setting a decimal limit, and removing trailing zeros. For more information, see Widgets.

  • For the Time Series Graph widget, selecting “Tier / Node Health - Transaction Performance” as your Metric Category to view infrastructure metrics no longer provides data points since it now correctly corresponds to overall application performance metrics. To see infrastructure metrics, you must change the configuration to “Tier / Node Health - Hardware, JVM, CLR”. For more information, see Widgets.

Universal Agent 

  • The AppDynamics Universal Agent is a deployment tool that automates the tasks of installing, running, and maintaining AppDynamics agents. The Universal Agent runs on Linux and Microsoft Windows systems, and is best used to manage agents in very large deployments. In this release, the Universal Agent adds support for managing the .NET Agent, Analytics Agent (for Transaction Analytics), and Network Agent. For more information, see AppDynamics Universal Agent

User Management

  • You can create and manage users, groups, and roles using RBAC REST APIs. For more information, see RBAC API.

License Management

  • You can manage licenses for Network Visibility on the License page.

Resolved Issues

 

KeySummary
ALERT-6Action dialog UI freezes when an existing action within an email template is opened, saved, or edited
ALERT-17Deep link URL provided by a custom action linked to an AppServer restart event is broken
ALERT-24Health rule evaluation for a metric with rollup type=CURRENT takes first unit of time in the interval when it should take the last
ALERT-25Health rule fires even when the machine agent availability metric is not reporting due to issue with association
ALERT-32500 error occurs when you try to retrieve Export Actions with invalid application name
ALERT-122Triggering issue with HTTP request actions on SaaS Controller is fixed by enabling logging of HTTP actions to the server log
ALERT-215Health rules trigger false positive alerts due to inaccurate baseline values
ALERT-217Recursive check on metric conditions fixes enforcement issue with the EUM license requirements when creating health rules
ALERT-236No text field present under drop down "Servers/Node matching the following Criteria" for default health rules
ALERT-415HTTPActionPlan double encodes query parameter
ALERT-505Unable to save health rule if Group Count is selected
ALERT-538Incidents remain open even after health rule returns to NORMAL
ALERT-569Potential security issues detected in third-party libraries
ALERT-571Events which trigger actions show actions triggered even if the action is set to disabled
ALERT-589"Disk Usage is too high ..." health rule status does not get evaluated
DASH-582Widget title is overwritten when opened for editing
DASH-952Dashboard with Metric Value widget displays values as "_ _"
PLATCPS‑1095License rule dialog does not filter out removed apps/machines when editing a license rule
RPTSVC-7Absolute layout dashboard now uses the dashboard size to set the content page size
RPTSVC-104Dashboard and Audit Reports do not show current timezone data
UIPLAT-589Settings gear icon is unresponsive for Controllers with custom instance methods
UIPLAT-300License rule name containing "&" is not selectable in the UI

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

 

Enhancements

Controller Enhancements

  • You can set up a trust called federated friendship between business applications in different accounts on one or more Controllers. When business applications from the friend accounts make entry and exit calls to one another, they show up in flow maps as federated cross application flow.
    Federated cross application flow works with Java and .NET agents that are version 4.4 or later.

  • You can filter business applications from flow maps that show cross application flow. The filter does not apply to applications in other accounts participating in federated cross application flow.

  • In live preview mode, the number of methods and classes that can be returned by an agent are now limit-bounded. The limits are:
    • Maximum number of classes: 1000
    • Maximum number of methods: 300
    For more information on live preview mode, see Custom Match Rule Live Preview.

C/C++ Agent Enhancements

  • You can override the default business transaction start time using the appd_bt_override_start_time_ms method. The default start time is epoch time (January 1, 1970 UTC). For more information, see C/C++ Agent SDK Reference.

Go Agent Enhancements

  • The Logging property in the Config struct lets you configure logging settings, such as where log files are written to and the maximum number of logging files to store on disk. For more information, see Go Agent SDK Reference.

Java Agent Enhancements

  • You can register the spring-mvc-naming-scheme node property to configure naming of Spring MVC requests. See spring-mvc-naming-scheme node in App Agent Node Properties Reference for more information.

  • A new system property, appdynamics.agent.ssl.keymanager.factory.algorithm, let's you set the algorithm pertaining to SSL Mutual Authentication between the Agent and Controller. To use the property, add the option to the JVM startup command, as in the following example:
    -Dappdynamics.agent.ssl.keymanager.factory.algorithm=PKIX

  • The Java Agent automatically detects Mule ESB HTTP and JMS entry points for versions 3.6, 3.7, 3.8, and 3.9. It also discovers Mule ESB HTTP exit points for the same versions.

  • The agent now supports Java 9. See Java Supported Environments for complete support information.
  • The Java Agent adds support for JMX Metrics for Kafka Broker.
  • The Java Agent adds support for Eclipse Vert.x versions 3.4.1 and 3.4.2.
  • Backend support added for Ning Asynchronous HTTP clients version 1.x (NingAsyncHttpClient) and 2.x (AsyncHttpClient).
  • Previously, with the -Dappdynamics.agent.reuse.nodeName property enabled, the Java Agent wrote log information to a buffer. After registering with the Controller, it wrote the buffered logs to a log directory created upon registration. If registration failed, however, the buffered log messages were lost, making it difficult to troubleshoot startup and registration issues.
    Now, prior to registration, agent logs are written to stdout by default, and you have the additional option of having them written to a log file instead. Writing to a log file enables you to troubleshoot agent startup problems in case registration fails. See Instrument JVMs in a Dynamic Environment for more information.

.NET Agent Enhancements

  • The .NET Micro Agent no longer requires the AppDynamics .NET Agent Coordinator Service. You can install the .NET Micro Agent directly on Azure App Services and Azure Service Fabric.

  • When the .NET Micro Agent is installed on Azure App Services and Azure Service Fabric, it installs the project files to <project_root>/AppDynamics/AppDynamicsConfig.json.
  • The .NET Agent supports Microsoft ASP.NET Core on the full .NET Framework 4.0+ hosted on Kestrel, WebListener, and OWIN. The agent names transactions based upon MVC area, controller, and action by default. See Name MVC Transactions by Area, Controller, and Action. To use Browser EUM with .NET Core on the full framework, you need to use Assisted Injection for the Javascript Agent.

  • The .NET Agent includes correlation support for Service Remoting in Azure Service Fabric.
  • The .NET Agent supports the Task return type for Method Invocation Data Collectors.

  • The .NET Agent includes the following backend and remote service updates:
    • Improved naming for Azure Table and Azure Blob backends.
    • Support for the MongoDB version 2.2 sync API.
    • Support for the Redis StackExchange client.
  • .NET Agent requires Universal C Runtime. If the installer warns you that it is not installed on your Windows server, take one of these steps:

Node.js Agent Enhancements

  • You can configure your logging settings to log to STDOUT by setting the outputType parameter in logging settings. For more information, see Node.js Agent Logging.
  • In Process Snapshots, you can view data on asynchronous activities in the Node.js event loop for N|Solid processes. For more information, see N|Solid Monitoring Data.
  • For the txn.addSnapshotData and txn.addAnalyticsData methods, the key and value arguments are no longer coerced to string. Numeric values are properly passed as integers, floats, etc.

Upgrade Notes

  • BrokerURL is no longer supported as a backend identification name for Kafka consumer backends. If using it as a naming property, you will need to change the configuration to use another identifying property. 

Resolved Issues

KeySummary
APMPLAT‑138Last JVM start time showing current date on node list dashboard
APMPLAT-524Application List Flow View doesn't show EUM application
APMPLAT-540Frequent logging with "Invalid principal name: ANONYMOUS" for hotspot learning 
APMPLAT-727Clicking the All Other Traffic BT in Tier Snapshots navigates to different All Other Traffic BT
APMPLAT‑923Metric browser log scale rendering is broken when values contain non zero, zero, and no data
APMPLAT-978Business transaction configuration UI for .NET incorrectly indicates Perl-style regular expression support
APMPLAT-1366Rest API calls failing due to encoding issue 
APMPLAT-1552Business Transaction list slow response when searching/filtering
APMPLAT-1569500 ISE exception appears when a read-only user tries to exclude a service endpoint on the SEP Dashboard 
APMPLAT-1573Same value for current and average value in dashboard
APMPLAT‑1602Duplicate "All Other Traffic" per tier on business transaction limit reached 
APMPLAT-1754Machine agent keeps consuming license even though the machine instance has been deleted
APMPLAT-1854Creating rule in Live Preview for POCO BT, the Name text box loses focus
APMPLAT-1855Exceptions list illegible due to overlaid text
APMPLAT-2061Machine Snapshot with Archive enabled do not show as Archived in Controller GUI
APMPLAT‑2064RBAC: Configure Service Endpoint not working at application/tier level
APMPLAT-2117Improved performance needed for hasEUMADDs 
APMPLAT-2236'Deleting' message needed when events are being deleted
APMPLAT-2245Application dashboard performance issues due to getMobileApplicationsCount
APMPLAT‑2355Unable to download JVM Crash Logs with 403 forbidden error
APMPLAT-2415Application import did not import enabled POJO Business Transaction Match Rule
DOTNET-570Coordinator service hangs during restart
JAVA-543Ignore logged messages does not work with ignore exception
JAVA-696Merge delimiter is not used for ADO.NET/WebService/WCF/MongoDB Backend detection
JAVA-761NPE for instrumenting webObject
JAVA-896HTTP backends not being identified with BsonSerializationException
JAVA-909End-to-end latency is not reported for Tibco BW Process
JAVA-928Incorrect exit call count reported for exits based on Sun HttpURLConnection class in some cases
JAVA-1196Exception chain not differentiable from list in snapshot view in UI due to repeating same exception name
JAVA-1210Instrumentation broken for TibcoHttpEntryPointInterceptor
JAVA-1278Neutralization Error for com.singularity.snapshot.CallStackSampler
JAVA-1333Custom DB classes instrumented, but do now show up in snapshots or flow maps

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.
  • Inactive nodes do not get marked as historical despite appdynamics.jvm.shutdown.mark.node.as.historical being set to true.
  • Business transaction retention settings are not affected by the business.transaction.retention.period value in the Admin Console.

Database Visibility Notes

 

Enhancements

  • In the Execution Plan Window, the cached plans for SQL Server are rendered as diagrams for better readability.

Resolved Issues

 

KeySummary
DBMON-39Unable to see transaction snapshot for Microsoft SQL Database
DBMON-240Run-Duration sorting should be numeric
DBMON-388Collecter UI shows "agent is currently not reporting data"
DBMON-1028Missing executions and avg response time for SQL Server 2005 sp4
DBMON‑1228Database URL is broken after selecting custom time range


End-User Monitoring Updates

 

Enhancements

Browser RUM

  • To perform automatic injection for .NET, you no longer need to set the attribute runat="server" in the <head> element of the master or the aspx page.

Mobile RUM 

  • The Xamarin Agent, in addition to reporting native app crashes, now also reports uncaught exceptions. You can view the stacktraceintheCrash Details dialog, which will include the class and methods called. If you are in debug mode, you can also view the file names and line numbers in the stack trace.
  • The usage stats for connection types given in the Usage Stats tab of the Mobile Dashboard are now based on network requests, not app opens.
  • In addition to reporting crashes, network requests, usage stats, and sessions, Mobile RUM now also reports a number of non-fatal issues that don't cause crashes but negatively impact the user experience. The primary app issue is known as "application not responding" or ANR, but the list of non-fatal issues extends to security issues, UI issues, and exceptions. For this version, Mobile RUM will only support the non-fatal issues such as ANRs and exceptions.

Browser Synthetic Monitoring

  • You can install and run Synthetic Private Agents on internal networks to monitor internal websites or services that aren't visible to the public Internet. You can also use Synthetic Private Agents to test from specific locations or within your premises. Synthetic Private Agents require a separate license allocation from Hosted Synthetic Agents. 
  • Synthetic jobs can now check the availability of resources. You can set the session state to "Warning" or "Failed" when a resource is missing, and configure alerts accordingly. See Configure Availability Rules to learn how.
  • You can choose a mobile browser to run a script or URL measurement. The synthetic job runs Chrome in the mobile emulation mode with the profile properties for the selected mobile browser.

Resolved Issues

Browser RUM 

ComponentSummary

BRUM-7

The EUM Installer fails on Windows when the Database password has the character '^'
BRUM-8The EUM Installer fails to connect to the Events Service over HTTPS configured with custom CA certificates
BRUM-9Uninstalling the EUM Server on Unix machines can in some cases remove the Controller installation
BRUM-10EUM Upgrade: Silent EUM upgrade doesn't take into account the mysql.dbHostName parameter in a split-host setup
BRUM-272Some IP addresses resolve to a country named "Asia/Pacific Region"
BRUM-308The EUM Installer does not preserve a customer's root certificate
BRUM-829Validating large mapping files causes an "Out of Memory Error" (OOME) on the Geo Server
BRUM-942When configuring applications, the App Server Agents incorrectly fetch non-business applications, such as EUM apps
BRUM-1089The EUM license does not get pushed to the EUM Processor until you create an application
BRUM-1141Upgrading to the 4.3.3.0 JS Agent resulted in an increase of AJAX CORS errors
BRUM-1184The Getting Started page cannot send and verify a test page because of a "403 Forbidden" error
BRUM-1269Events service URL converted to http from https

Mobile RUM

ComponentSummary
MRUM-650The Controller's registration heartbeat that keeps apps and accounts alive is unreliable
MRUM-1036The cURL query to get the last 50 Proguard mapping file gives the first 50

Browser Synthetic Monitoring

ComponentSummary
SYNTH-59The synthetic session details dialog should always display a visual complete time for each page
SYNTH-1158Some types of failures have ambiguous error messages
SYNTH-1159Sessions stall when synthetic scripts open a second window and then close it.

EUM UI

ComponentSummary
EUMUI-108The server time in browser snapshots is greater than the overall end user response time
EUMUI-529The "Synthetic Requests per Minute" needs to be removed from the "Browser App List"
EUMUI-680The "Getting Started" wizard for creating EUM apps fails to check for existing APM application names
EUMUI-725Unable to export records on EUM_WEB_ANALYZE page
EUMUI-965The "Browser Sessions > Charts" tab uses the wrong unit of measurement for the "Least Available Jobs" widget
EUMUI-993The frequency dropdown misleads customers into thinking that jobs can be scheduled at 1-4 minute intervals

Infrastructure Visibility Notes

Integrated Network Visibility

With Integrated Network Visibility, you can 

  • Answer the key question quickly and easily: Is the network to blame for any performance issues in my application? 
  • Identify the root cause of performance issues in the application, the network, or in application/network interactions (i.e., how an application or server utilizes the network).
  • Pinpoint the traffic flows, individual nodes, and transport connections where network or application/network issues are occurring.
  • Collect detailed metrics that show how the network is performing and how well your application uses network connections and resources.
  • Collect and report targeted troubleshooting information to network, IT, DevOps, and other teams. 

Network Visibility is supported on Linux hosts with Java App Server agents. See Network Visibility.

Enhancements

Server Visibility Enhancements

  • Starting in November 2017, APM Advanced and APM Peak Edition licenses include one Server Visibility unit that covers one OS instance. Standalone licenses for Server Visibility are also available; AppDynamics sells each standalone license for Server Visibility in packs of 3, covering 3 OS instances. See License Entitlements and Restrictions
  • Server tagging makes it easy to query, filter, and compare related servers using custom metadata. You can tag related servers based on OS, location, tier, owner, or any other relevant criteria. Server tags provide additional context to server metrics.
    Server tagging is currently available for Linux, Windows, and Solaris. See Server Tagging.
  • The ServerMonitoringConfig.yml file (under <machine-agent-home>/extensions/ServerMonitoring) has the following changes:
    • The following settings enable you to configure the rate at which the Standalone Machine Agent collects specific sets of metrics on Linux hosts:
      • memoryMonitorConfig – memory metrics
      • cpusMonitorConfig – CPU metrics
      • volumeMonitoring > samplingInterval – volume metrics
    • The volumeMonitorConfig > blacklistSelectorRegex setting has been updated to exclude Docker volumes by default. This change was introduced to prevent high data loads that can occur from monitoring a lot of ephemeral Docker volumes. 

Resolved Issues

Server Visibility Resolved Issues

Key
Summary
SERVER-1198Service Availability generates alerts even if DNS lookup is down
SERVER-1202Service Availability trims response data even after maxDownloadSize is increased in Controller
SERVER-1208Standalone Machine Agent throws exception when Docker Visibility is enabled: "chroot: can't change root directory to '/hostroot': No such file or directory"
SERVER-1211Fix to support turning off process monitoring when too many processes slow down performance on Standalone Machine Agent
SERVER‑1928Service Availability - Custom Filters not Working correctly

Standalone Machine Agent Resolved Issues

Key
Summary
SERVER-8064.2.1 machine agent stopped reporting metrics when NFS volume became stale
SERVER-1210JVM Crash Guard does not report crashes after App Server Agent is killed (Machine Agent does not detect kill event)
SERVER-1213Memory Utilization metrics are not reported correctly on Windows
SERVER‑1370appdynamics-machine-agent.pid not present in /var/run/appdynamics
SERVER-1551Standalone Machine Agent does not handle backslash character correctly on Solaris 11
SERVER-1639Metric Browser > Server & Infrastructure does not show Custom Metrics folder 
SERVER-1640Machine agent fails to collect raw data
SERVER-1696<use-simple-hostname>true</use-simple-hostname> not working as intended
SERVER-1710Linux Machine Agent cannot handle /proc/partition files that have a lot of partition entries
SERVER-2120Standalone Machine Agent cannot collect OS metrics on Red Hat Enterprise Linux 7.4

 

Known Issues

Server Visibility Known Issues

  • If a metric name contains colons (:), the Metric Browser interprets the name as hierarchically separated.
  • A machine agent enabled for the 4.1 Server Monitoring Beta will not work with a 4.4 Controller. To continue using Server Visibility (previously Server Monitoring), upgrade both the machine agent and the Controller.
  • 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:
    https://community.appdynamics.com/t5/FEZ-Knowledge-Base/Server-Visibility-Support-Advisory/ta-p/22408

 

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.
  • (Fixed in 4.4.2 App Agent and 4.4.2 Standalone Machine Agent) When multiple containers within a Kubernetes pod are monitored by the Standalone Machine Agent, the data can be inconsistent.
  • 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.

Standalone Machine Agent Known Issues

  • Reset Machine Agent action on the AppDynamics Agents window is not available for 4.4 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.

     

Application Analytics Notes

Enhancements and Updates

Agent Status

Visualization and Widgets

  • Funnel widget improvements include:
    • The ability to display the performance overlay on the funnel bar and show how many of the participating events in the step are in normal or slow or in error category. This is the Show Health option in the properties pane.

    • Ability to see the underlying events related to abandoners (drop-offs) at each stage of the funnel.

    • Visual layout improvements

  • Property panes have been added to the Analytics widgets to provide more control over the widget appearance.
  • The transaction Live Stream widget is no longer supported.

Log Analytics

Business Outcomes

Business Outcomes are a way to monitor and correlate the data flow across multiple event sources. See Business Journeys.

Experience Level Management

Experience Level Management (XLM) enables you to configure and schedule regular reports measuring performance against established service or experience levels. See Experience Level Management.

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 4.3 or 4.4 agents, 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 affect 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 be 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

 

KeySummary
ANALYTICS-1339Analytics table widget should retain column width in Custom Dash
ANALYTICS-1375Scrolling analytics searches in Chrome results in jumping straight to the bottom of the page
ANALYTICS-1395No validation when zooming in on analytics query
ANALYTICS-1424Analytics UI : hide/unhide does not work for custom fields having special characters
ANALYTICS-1442Page Name column wrapped up on dashboard and report on Analytics -> Custom Widget Builder
ANALYTICS-1754Browser Analytics: Timestamp field needs to be fixed
ANALYTICS-1981Data collectors populating incorrect values in analytics
ANALYTICS-2301Type ahead auto completion only works for the first 100 entries
ANALYTICS-2889

Proxy settings in admin.jsp requires controller restart

ANALYTICS‑3158

Funnel widget steps do not allow drop-down selection of more than 100 records

ANALYTICS-3379Unrecognised field "error_details" for Analytics widget in custom dashboard
ANALYTICS-3262ADQL returning only the first element from the data collector list

Known Issues

  • To deploy the Analytics Agent on Linux using the Universal Agent, you must use machine-agent mode.
  • Windows: 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 for business transactions may not appear immediately when 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.
  • When defining Business Outcomes, you can not delete the same field from one milestone and add it to a different milestone in the same Save action. To workaround this issue, delete the field from the first milestone and save the definition. Then edit the Business Outcome again and add the field to the second milestone and save the definition.


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. 

Enhancements

Enterprise Console

  • The Enterprise Console (formally known as the Platform Administration Application) is the installer for the Controller and Events Service. You can use it to install and manage the entire lifecycle of new or existing AppDynamics Platforms and components. The application provides a GUI and command line interface that you can use to perform the following tasks:

     Multi-Platform Management

    • Manage multiple platforms at the same time using the application
    • Discover, install, and upgrade Controllers, Event Services, and MySQL nodes

    HA-LifeCycle Management

    • Manage High Availability (HA pair) lifecycle without the use of the CLI based HA-toolkit or sudo privileges
    • Perform failover management

    Other Features

    • Manage Controller and Events Service lifecycle
    • Utilize GUI & CLI support
    • Manage AppServer and database configurations

    See Enterprise Console for more details.

Controller

  • The default values for Event and request segment data (RSD) rate limits have been set to 7,000 and 30,000, respectively. This will reduce the need to update the values as the new default values are based upon realistic expectations.
  • The default value for the flag, application.diagnostic.data.purge.enabled, has been set to true. You can update the flag value in the Controller Settings. This setting helps with clearing up disk storage space by purging stale entites and their metrics.

EUM Server

  • The EUM Server product installation now allows you to install the EUM Server and a MySQL database instance on a single host.
  • If you have migrated your EUM Server from version 4.3.x or earlier to version 4.4,  you must migrate the MySQL instance previously stored on the Controller host to the EUM server host. For instructions, contact your AppDynamics Sales or Professional Services team.

Events Service

  • The IllegalStateException error generated when the Controller is not connected to an Events Service is now throttled to once per minute. There is also a change in logging messages, where EJBException is now a ControllerTimerTaskBean exception, when the Events Service is not configured.

Upgrade Notes

  • You can upgrade your Platform with the Enterprise Console. The Enterprise Console simplifies the upgrade process by allowing you to discover and upgrade Controllers, Controller HA pairs, and Events Service thought its GUI. You can pick and choose the platform or service to upgrade once your Enterprise Console is installed or upgraded. The Enterprise Console supports Controller (standalone and HA-pair) and Events Service upgrades starting from 4.1 and higher to the latest version. If you are on an earlier version like 3.x or 4.0.x, and would like to upgrade to 4.4, you would need to use the package installers and first upgrade to 4.1. Then use the Enterprise Console to upgrade to 4.4. See Upgrade Platform Components for more details.

Resolved Issues

 

KeySummary
ECONSOLE-270Mac OSX Platform Admin 4.3.0.4 installer is corrupt due to Oracle JRE changes
ECONSOLE-711References to the 4.2 Platform Admin remain after upgrading to 4.3
ECONSOLE-938Controller 4.3.3 Installer fails with varfile usage
ECONSOLE-968Installer does not check for overlap between MySQL data directory and other installation directories
ECONSOLE-1052"Port number xxx conflicts" for the TCP/Unicast port error
METADATA-624Unable to create user with username "root" in 4.3
METADATA-1284Unable to delete custom role due to Controller permission migration
METADATA‑1432Obsolete child metric to virtual metric relationships are not invalidated and removed from the metadata cache when updating virtual metrics
METRICSVC-374Multiple time-slices for rollup breaks custom dashboard widgets
UIPLAT-2334.3 Controller login page loads very slowly on IE

Known Issues

  • A known issue prevents the Controller database from starting at installation time if another instance of MySQL is running on the machine. Certain Linux operating system distributions include MySQL. If the bundled MySQL instance is running, you will need to shut it down to complete the AppDynamics Controller installation.
  • To run multiple Events Services on a Windows box, copy the bits to multiple directories and install them as service. A unique suffix to the Events Service service name will be auto generated based on the directory path of the bits. The executor on Windows does not support changing the process name in properties files.


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.

4.4.0.4 Updates

Resolved Issues

KeySummary
ANALYTICS-4104Custom User Data Missing From ADQL Data Grid
METADATA-1905Flow map loads very slowly after upgrade

4.4.0.5 Updates 

Resolved Issues

KeySummary
APMPLAT-3167Wrong name and exit type for DynamoDb remote services after upgrade

4.4.0.6 Updates 

Component Versions

  • Enterprise Console 4.4.0.4731

Resolved Issues

 

KeySummary
ANALYTICS-3772Scheduled queries observed in SaaS instances run every 15 mins with excessive duration and no metrics
ANALYTICS-4516Metric jobs fail with java.util.concurrent.CancellationException
BRUM-1957Controller threads leaking, resulting in out of memory errors
DBMON-1483Deploying a large number of DB Agents causes agent pool saturation 
ECONSOLE-1932Backup Controller upgrade fails due to keystore file mismatch between primary and secondary Controllers 

4.4.0.7 Updates 

Resolved Issues

KeySummary
DBMON-1511Database Agent causing excessive CPU utilization

4.4.1 Updates

If a 4.4.1 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).

Version 4.4.1 applies updates to: 

Enterprise Console

Enhancements
  • The Controller JRE has been upgraded to version 8u152 to fix sporadic JRE crashes.
  • Enterprise Console: The MySQL upgrade requires glibc2 (2.12 or later) and libnuma libraries to be present on Linux.
  • You can edit your platform name from the Enterprise Console UI.
  • MySQL has been upgraded to 5.7.20 to address security vulnerabilities. 
Resolved Issues
KeySummary
ECONSOLE-1876Controller installation fails on OS with Non English Locale
ECONSOLE-19324.2 to 4.4 High Availability Console upgrade failed

Controller

 

Enhancements
  • You can use account level configurations to enable dashboard/widget limits on large numbers of JMX instances or nodes instrumented in one application while returning widget data. This also includes threshold checks for business transactions, errors, servers, and backend data. This applies to the JMX type metric in a widget's “Type of Nodes” menu. The “All Nodes in the Application” option becomes disabled if the number of nodes exceeds the threshold. An error is returned if the number of any threshold is exceeded on the backend. This should help prevent outages.
Resolved Issues
KeySummary
APMPLAT-1819REST API skips reporting of some events
APMPLAT-2846Unable to scroll in Instrumentation screens using Chrome
APMPLAT-2595Changes do not persist when adding new value in "Detect Errors based on Redirect Pages" table
PLATCPS-1571In some cases, synchronization issues can cause agent license to be denied incorrectly

 

C/C++ Agent

Enhancements
  • A proxyless version of the C/C++ agent is now available, which means you no longer need to run a proxy to install and use the agent. The proxy is replaced with a process called libagent.
  • You can enable SSL for the proxyless C/C++ agent.
  • The /opt/appdynamics-sdk-native/sdk_lib/ directory path has been modified to /opt/appdynamics-cpp-sdk/.  You may need to update your include and library paths to reflect the new library and header file locations.

Node.js Agent

Enhancements
  • You can set the following properties:
    • reuseNode: set to True to enable reusing node names. This property is useful for monitoring environments where there are many nodes with short life spans.
    • nodeReusePrefix: set to the string that prefixes the node name when reuseNode is set to true. The Controller uses this prefix to generate node names dynamically.
    • certificateFile: set to the directory path of the SSL certificate.

.NET Agent

Version 4.4.1.1097 – Jan 31, 2018

Enhancements
  • All versions of Microsoft ASP.NET Core are supported on the full framework, most recently ASP.NET Core 2.0.
  • WebJobs using Azure queues and Service Bus triggers are supported.

Resolved Issues
KeySummary
DOTNET-934.NET Agent does not start automatically on machine startup due to Coordinator service crash
DOTNET-972.NET RabbitMQ Instrumentation can cause high CPU and (in rare cases) a race condition leading to application errors

Version 4.4.1.1765 – Jan 31, 2018

Resolved Issues
KeySummary
DOTNET-758Agent internal method (Reflection.Invoke) shows up on callgraphs for no dependency instrumentation
DOTNET-924Azure Cloud Services package - Node naming behavior changed in 4.3, reverting to 4.2 behavior
DOTNET-929Getter chain like GetType().Name not working on Parameters in POCO for splitting
DOTNET-1164Azure Extension using JSON Config is instrumenting all the .net processes running on Azure instance
DOTNET-1168Private methods are not visible while doing the Live Preview Class Method Browser
DOTNET-1221EUM automatic injection: Response type other than 'html/text' should not be scanned by HtmlAgilityPack
DOTNET-1303ASP.NET Core 2.0 on the .NET Full Framework crashes

Java Agent

Resolved Issues
KeySummary
JAVA‑1397When monitoring Glassfish Jersey transactions with custom rule, Java Agent detects BTs in live preview but not when custom rule is saved
JAVA‑1503Nodes do not get marked as historical in some cases

Database Agent

Enhancements
  • When using CyberArk for Database Visibility, you can customize the application name in your CyberArk manager. Previously, the application name was set to AppDynamics and could not be customized.
Resolved Issues
KeySummary
DBMON-1244When a backend is linked to a collector for an Oracle cluster, UI shows individual nodes instead of one Collector
DBMON-1390Not showing insert/update query for Mongo DB

Universal Agent

Enhancements
  • Previously, a rulebook could include the sim-enabled property, which specified whether Server Visibility is enabled. The default value of this setting was true. This default overrode the Machine Agent bundle configuration setting, which is false by default. This release changes the priority of default, so that the machine agent bundle configuration (false) default prevails over the rulebook default. See Enable Server Visibility for more information. 
Resolved Issues
KeySummary
UNIAGENT-244The Universal Agent does not report that .NET Agent start failed configuration
UNIAGENT-293default.json has misleading comment
UNIAGENT-294config.xml not correctly patched with empty XML
UNIAGENT-306Ability to control dotnet-compatibility-mode attribute in rulebook required
UNIAGENT-308Default to default.json configuration file rather than first available 

Application Analytics

Enhancements
  • ADQL - Support for the datetime data type is added for the BETWEEN keyword.
  • Business Outcomes - The default value of the analytics.business.outcomes.flowmap.enabled property is now set to true. With this change, a flow map detailing the business workflow is automatically displayed upon selecting a Business Outcome event. Use the Controller Settings to change the default behavior. 
Resolved Issues
KeySummary
ANALYTICS-3948Drilldown into Analytics Widget causes HTTP 404 error 

Server Visibility

Resolved Issues
KeySummary
SERVER-2219Controller UI stops working intermittently due to threadpool saturation
SERVER-1985Servers drop down is empty while editing the service monitoring configuration

Network Visibility

Enhancements

You can now copy IPs and ports for individual connections from the Network Dashboard. This makes it easy to forward this information to operations and other personnel when troubleshooting an issue. To copy IPs and ports:

  1. Click on a link to open the link popup and go to the Connections tab.
  2. Select the connections of interest (use ctrl-click to select multiple connections).
  3. Right-click on the selection and choose Copy IP addresses to clipboard.

Browser Real User Monitoring

Resolved Issues
KeySummary
BRUM-903XHR requests that take longer than 30 seconds are not reported in some cases
BRUM-1455

EUM application configuration updates can be extremely slow to propagate to some geographic regions

BRUM-1957Fix to prevent thread leaks in 4.4 Controller

Mobile Real User Monitoring

Enhancements

The Android SDK includes new APIs for disabling and enabling screenshots from being taken for blocks of code. Calling the method blockScreenshots will disable screenshots until you call the method unblockScreenshots. You can also call screenshotsBlocked to determine whether screenshots are being blocked by this new API.

Resolved Issues
KeySummary
MRUM-1017iOS Agent generates a Main Thread Checker warning under Xcode9
MRUM-1167Some Xamarin network requests are not getting sampled
MRUM‑1322The iOS SDK Screenshot triggers the exceptions "ADEumScreenshotOperationsController" and "ADEumApplicationWillResignActive"
MRUM‑1345Repair Crash in iOS Agent when using File URLs with URLSession
MRUM‑1346On Windows Android Studio, the task ":app:clean" fails when running an instrumented app
MRUM‑1511iOS Agent generates a "Main Thread Checker" warning under Xcode 9 during an ANR

Browser Synthetic Monitoring

Enhancements

The hardware has been upgraded for the Synthetic Host Agent locations listed below. In these locations, synthetic jobs will run faster, time out less often, and consume fewer license blocks. The increase in speed depends on what your jobs do, but testing has shown speed increases of 10–40%. 

  • Ashburn, VA, USA
  • Boardman, OR, USA
  • Dublin, Ireland
  • Frankfurt, Germany
  • Mumbai, India
  • San Francisco, CA, USA
  • Sao Paulo, Brazil
  • Seoul, South Korea
  • Singapore
  • Sydney, Australia
  • Tokyo, Japan
Known Issues
  • If Synthetic jobs embed credentials in a URL (e.g., http://user:pass@example.com/), the credentials will be redacted from the session results. Page names that include credentials will become inactive, and new pages without the credentials will be created. If you have reached the limit for registered pages, you will need to remove the orphaned page before you'll see data for the new page.

4.4.1.4 Updates 

You can find this update in the following:

  • Enterprise Console (Version 4.4.1.7606 – March 31, 2018)
  • Controller (Version 4.4.1.4)
Resolved Issues

 

Key
Summary
SERVER-4404

Fix to delete unassociated machine instances and prevent excessive thread pool consumption on Controller

SERVER-4350

Machine Agent name check is case-sensitive, which prevents some agents from registering with Controller

SERVER-4040

In some cases, Service Availability data takes a long time to load in the Controller UI

SERVER-4039

Fix to ensure that Controller processes string values from Machine Agent

4.4.1.1803 Updates

This release introduces the ABAP SAP Agent, the AppDynamics app agent for monitoring SAP Applications. For documentation on this agent, see SAP Monitoring Using AppDynamics.  

4.4.2 Updates

Version 4.4.2 applies updates to:

Platform (4.4.2.6270 - March 2, 2018)

  • The Enterprise Console now supports incremental replication, which is required in cases where the database replication on the secondary Controller of an HA pair is lagging behind the primary Controller by more than three days.
  • You can now change the data directory path on the Controller Database Configurations page of the Enterprise Console.

Resolved Issues

 

KeySummary
APMPLAT-2682REST API for retrieving tier information does not work when tier name includes forward slash ('/')
APMPLAT-3153Exclude Rules do not work when EJB name contains "$$$"
DASH-1225Heap Usage in Memory tab for a node shows incorrect value in Internet Explorer
ECONSOLE-1928Fixes to install-init.sh shipped with Enterprise Console
ECONSOLE-1940High Availability: Enterprise Console shows incorrect status for secondary controller
ECONSOLE-1953Fix to ensure that recommended custom settings in domain.xml are retained when Controller is upgraded
ECONSOLE-20054.4 upgrade of on-premise Controller failed due to very large domain.xml file
METADATA-1612Failed to find corresponding principal in MDS due to mismatched IDs in mapping table
METADATA-1893Cannot view License and Databases in UI or log in as new user after Controller upgrade from 4.2.2.0 to 4.3.5.7
METADATA-3424On-premise v4.1 to v4.4 controller upgrade failed to create mds_* MySQL schemas
PLATCPS-1680Getting ERROR Checking SAML while logged into the controller using SAML

Controller (SaaS: 4.4.2.0)

Enhancements

  • SaaS Controllers have a new Settings menu () option, Show SAAS Status. Clicking the option takes you to the service status page for your SaaS account, https://portal.appdynamics.com/status/saas/. There you can see incident and maintenance reports for your environment, among other information.

End User Monitoring (4.4.2.21690 - March 22, 2018)

Enhancements

  • The iOS SDK and Android SDK now have APIs for blocking and unblocking screenshot capture for blocks of code. See Block/Unblock Screenshots (iOS/Android) for more information.

Resolved Issues

 

KeySummary
EUMUI-1439Browser sessions data missing due to UI error
MRUM-1454Android runtime dependency injector interferes with authenticating Maven repositories
MRUM-1467Android NDK cannot find plugin property in newer Gradle plugins
SYNTH-1803Missing resources in Chrome measurement due to undetected frames

 

Analytics (4.4.2.1457 and 4.4.2.16284)

 

Version 4.4.2.1457 - March 2, 2018 

  • The Event Details page has been enhanced to include Device Model, Device OS, Devices, Job Name, and Screenshot Timestamp fields. These values are derived from the associated EUM synth session event.
Resolved Issues
KeySummary
ANALYTICS-3841ADQL Query Incorrectly Updated When Sort Order Is Modified In Existing Visualization Widget
ANALYTICS-4232Analytics Agent Field Mapping Contains Blank String
ANALYTICS-4453Group By with Null or Empty Field throws off count
ANALYTICS-4540Snapshot operations do not run when Events Service is set up for HTTPS

 

Version 4.4.2.16284 - May 1, 2018 

Resolved Issues
KeySummary
ANALYTICS-7886Error performing manual upgrade of Events Service to 4.4

 

Dynamic Languages (4.4.2)

  • Node.js v 9.0.0 is now supported.

Resolved Issues

KeySummary
DLNATIVE-927NodeJS agent with default configuration does not work with cluster module
DLNATIVE-967Inconsistent node-level metrics observed for some time resolutions on specific application

C/C++ Agent (4.4.2.0 - March 2, 2018)

Resolved Issues

  • Occasionally, the appd_sdk_term call hangs when communicating with the controller in previous versions of the agent. This issue is fixed in 4.4.2.
KeySummary
DLNATIVE-1034Deadlock in appd_sdk_term()

Java Agent (4.4.2.21763 – March 2, 2018)

  • The following attributes were added to the sensitive URL filter:
    • match-filter: the operator used to filter URLs. Valid operators include EQUALS, STARTSWITH, CONTAINS.
    • match-pattern: the URL sub-string that you want to filter for
  • Correlation is supported for Kafka.

Resolved Issues
KeySummary
JAVA-1478JMS Receive BTs are marked as POJO BTs and JMS BT disable/enable options are not honored
JAVA-2127RabbitMQ Message Properties get changed when correlation is enabled

Java Agent (4.4.2.22394 – March 6, 2018)

Resolved Issues
KeySummary
JAVA-3192Agent not starting with JDK 1.9 as JRE runtime version

.NET Agent (4.4.2.1835 - March 2, 2018)

Resolved Issues

Key
Summary
DOTNET-1246EUM auto-injection causes page-loading failure for custom resource handler BT

Network Visibility (4.4.2.609 - March 2, 2018) 

  • The following metrics are now available in the Metric Browser > Application Infrastructure Performance > Host > Interface:
    • # Receive Drops –  Number of packets dropped while receiving by all interfaces on the host
    • # Transmit Drops – Number of packets dropped while transmitting by all interfaces on the host
  • You can now install the Network Agent as an extension using the 4.4.2 Standalone Machine Agent installer. This option is available on Linux 32-bit and 64-bit ZIP installers only.

Resolved Issues

KeySummary
NETWORK2111High number of duplicate "update infra_netviz_callchain_interconnect" error log messages get generated in some conditions

Standalone Machine Agent and Server Visibility (4.4.2.742 - March 2, 2018)

Resolved Issues

 

KeySummary
SERVER2204Docker names being parsed incorrectly
SERVER-2255Standalone Machine Agent cannot collect metrics for blackhole networks or NICs names with asterisk('*')
SERVER-2291In Kubernetes deployment, Standalone Machine Agent reports incorrect image ID and image name for the containers
SERVER-2344Docker Visibility – Some parts of Controller UI show container ID (with no context) rather than container name
SERVER-2459Server page shows data for 13 hours, not selected time range of 1 day (observed on SaaS Controller)

 

Database Visibility (4.4.2.328 - March 2, 2018)

Resolved Issues

KeySummary
DBMON-1348Too many SSH connections for DB agent to DB host
DBMON1436Incorrect active connection count for MongoDB cluster
DBMON-1443Error in agent registration after a collector is updated
DBMON-1452The query to get Oracle query detail statistics should take dbId as a parameter
DBMON-1460Schema dropdown list should be fetched based on server ID for Oracle RAC
DBMON-1461

"Query is Blocked by" card REST call always uses isDBCluster= false

4.4.3 Updates

Platform (4.4.3.9040 - May 4, 2018)

Controller

  • You can deploy a fresh Controller on AWS with Amazon Aurora Database. Aurora provides higher performance than MySQL, which allows you to scale your Controller to handle more metrics. Aurora also takes care of database backups and high availabilty for you by leveraging Amazon Relational Database Service (RDS).

    For on-premises deployments, you have the option of using the AppDynamics CloudFormation template to create a Controller stack. Once the stack is created, you can install the Controller using the Enterprise Console. See AWS Controller Deployment Guide for more information.

  • You can now unfriend and delete the friendship information of federated friendships between business applications in different Controller accounts. See Configure Federated Friendship and Federated Friendship API Reference for more information.

Enterprise Console 

  • You can view Enterprise Console job details on the UI while the job is in progress by selecting a job and clicking View Details. Warnings and errors are color-coded in yellow and red respectively. This should help with troubleshooting. See Enterprise Console Jobs for more information.
  • You can use the remove-dead-hosts command to remove unreachable remote hosts from the Enterprise Console. See Manage Hosts for more information.

Events Service

  • The architecture of the on-premises Events Service has changed such that the embedded ElasticSearch instance now runs as a separate process from the Events Service process.
    Administratively, the impact of this change is minimal. Starting or stopping the Events Service process starts and stops the associated ElasticSearch process. On Windows hosts, only the Event Service process is registered as a Windows service, so only one running service is visible. Nevertheless, stopping and starting this service handles both processes as well.
    You should allocate 1 GB of RAM to the Events Service process, whereas the ElasticSearch process heap allocation should match the amount your previously configured for the Events Service. Note that this implies an additional 1 GB of memory allocation is required compared to the previous architecture.
    You can tune the heap settings for each process separately using the following properties in the events-service-api-store.properties configuration file:

    ad.jvm.options.name=events-service.vmoptions
    ad.jvm.heap.min=1g
    ad.jvm.heap.max=1g
    
    ad.es.jvm.options.name=events-service.vmoptions
    ad.es.jvm.heap.min=8g
    ad.es.jvm.heap.max=8g


    The first set are the JVM and heap settings for the Event Service process, while the second set (beginning with ad.es) are the equivalent settings for the ElasticSearch process.
    Also, the newly introduced ad.dw.es.log.level property lets you control the log levels of the ElasticSearch process.

License Management

  • License rule entitlements are now converted when you replace an existing license that included individual agent SKUs with one that replaces the SKUs with the APM SKU.

Resolved Issues

 

Key
Summary
ALERT-2077

Some Health Rule misconfigurations result in large internal queues and delays in Health Rule evaluations

APMPLAT-3490Error response after copying/pasting REST URL from Metric Browser
APMPLAT3502Mixed-content error on JMX instrumentation page
APMPLAT-6062Unexpected exception triggered when trying to list errors in Troubleshoot > Errors window
APMPLAT-6100

Memory Utilization % in Tiers/Nodes List is greater than 100%

APMPLAT-6226Tier Dashboard shows nodes marked as Historical
APMPLAT-6356

Tiers and Nodes page > Agent Status field is blank when the Standalone Machine Agent is down

APMPLAT-6418

Some Transaction Snapshot queries result in timeouts or unexpected exceptions

DEVEXP-94Onboarding message strip blocks the UI navigation panel for non-admin roles
ECONSOLE-490Platform Admin needs to support setting/unsetting HTTP proxy
ECONSOLE-1856Platform Admin does not maintain EUM and Controller keys when upgrading Events Service
ECONSOLE-1936HA: Internal VIP syntax is checked incorrectly
ECONSOLE-1956Enterprise Console install failed because RAM/CPU/Disk requirements did not match the documentation
ECONSOLE-1982In some situations Retrieve Logs does not retrieve database.log and some other log data
ECONSOLE-1993Enterprise Console Controller discover/upgrade fails when http port (8090) disabled on Controller
ECONSOLE2037Enterprise Console handles hostnames up to 63 characters only, not 255 characters
ECONSOLE-2071Adding Secondary Controller fails when external and internal VIPs are specified
ECONSOLE-2083rsync timeout when creating secondary Controller
ECONSOLE-2545db.cnf user changes to root after upgrade using EConsole
ECONSOLE-2607Fix to prevent timeouts when upgrading Controllers with very large databases
ECONSOLE-2647EC/Controller cannot be installed on Windows VMs - Check for available memory fails
ECONSOLE-2691Enterprise Console RAM/CPU/Disk requirements do not match the documentation
ECONSOLE-2714appdcontroller init script fails to read HA flags from controller.global_configuration_local when using plaintext db/.rootpw file
ECONSOLE-2795

4.4.1 Enterprise Console cannot discover upgrade Controller due to File Descriptor leak

METADATA4277In some cases, upgrading Controller or changing access key can result in license reporting issues
PLATCPS-1730Fix to ensure that LDAP with SSL to Active Directory works with TLS 1.2
PLATCPS-3843Snapshot information is doubled after archive operation
PLATCPS-4210

Tiers & Nodes table does not show nodes for Standalone Machine Agents that were restarted after being marked as Historical

REPORTS-161Report background overlaps report title
REPORTS-180Generated reports include notched-circle "loading" icon if system.use.notification.message is enabled


End User Monitoring (4.4.3.23183 - May 4, 2018)

EUM Platform

A new instance of the EUM Cloud has been deployed in Frankfurt, Germany. To access the new instance, use the following endpoints:

  • EUM Collector: https://fra-col.eum-appdynamics.com/eumcollector/
  • EUM API: https://fra-api.eum-appdynamics.com/

IoT Monitoring

Enhancements

The IoT C/C++ SDK has open sourced and made available on GitHub. You can clone or fork the GitHub iot-cpp-sdk repository to either customize the SDK or make contributions.

Resolved Issues 

Key
Summary
BRUM2142Custom errors could be dropped after upgrade to 4.4.1.0
BRUM-2219Out of Memory Exception when parsing large geo-ip-mappings.xml file in EUM Server
BRUM-3084Illegal Argument Exception when parsing large geo-ip-mappings.xml file in EUM Server
EUMIOT-745Connected Device Dashboard > Network Requests > event > Start Time should appear in human-readable format, not UNIX Epoch
MRUM-1120Internal check to find EUM-enabled applications for user account is slow
MRUM-1528Proguard feature cannot handle non-ASCII characters
SYNTH-2329First Byte is calculated incorrectly

JavaScript Agent (4.4.3.560 - April 16, 2018)

Enhancements

Browser RUM's new SPA2 monitoring has been tested and certified to correctly auto-instrument Angular 1-5 and React single-page applications (SPAs). SPA2 monitoring should also support auto-instrumentation for other SPA frameworks. For more information, see Monitor Single-Page Applications. 

Analytics (4.4.3.16720 - May 4, 2018)

Enhancements
  • Business Outcome has been renamed as Business Journeys.
  • At the Business Journey level, a field named completed tracks 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 Analytics Search UI or an ADQL query for the desired Business Journey with the query string completed to view the status of the associated events.
  • Custom event data can be used to create Business Journeys. The Type drop-down shows custom events as well in the list of sources of the analytics data, such as Transactions.
  • All the fields associated with filters and optional filters are automatically collected as part of Business Journey Event.
  • ADQL series function has been improved for the UI. The keywords arguments, strictEndpoints, offset, rangeStyleBucketKeys have been added to ADQL.
  • The Dropwizard library bundled in the Events Service is updated to version 1.2.0.
  • If a regex pattern (including grok) is taking more than five seconds to match against a logline, extraction and further processing for those fields stop. Other loglines are not impacted so you are not interrupted. This behavior is now applicable to the dynamic Preview screens in the Centralized Log Analytics Configuration page as well.
  • The Analytics Mobile Requests Data includes these new fields: platform, requestContentLength, responseContentLength, and happenedinbackground

Resolved Issues

Key
Summary
ANALYTICS-4720Customer should able to delete an account and all the data associated with the account.
ANALYTICS-4118Data needs to be encrypted at rest.
ANALYTICS-4143Connection and "Failure to create SLM" errors after Event Service upgrade
ANALYTICS-1418Machine Agent and Analytics Agent bundled with Machine Agent use different trust stores.
ANALYTICS-6914Analytics: Analytics Not Firing Up On IBM JVM.

Java Agent (4.4.3.23079 - May 4, 2018)

Enhancements
  • The Java Agent adds support for Eclipse Vert.x version 3.5.

Resolved Issues

Key
Summary
JAVA-2188InstantiationException error occurs when starting JVM in some situations
JAVA-2279VerifyFailure on applying async interceptor
JAVA-3150NullPointerException on startup for AgentConfigWatchdog
JAVA-3178Empty external-services directory in IBM JVM installer

.NET Agent and .NET Microservices Agent (4.4.3.2209 - May 4, 2018)

Enhancements
  • Microsoft Orleans is supported on the .NET and .NET microservices agents.
  • .NET Core 2.0 for Windows is supported on the .NET microservices agent.
  • Support for Azure Service Fabric Remoting v2.

AppDynamics NuGet Packages

The following NuGet packages are now available. If you have used a previous version of an AppDynamics NuGet package, you will need to upgrade to the new version. See Upgrade AppDynamics.WindowsAzure NuGet Package.

AppDynamics.Agent.Distrib.Micro.WindowsAppDynamics NuGet package for .NET. This package should not be installed directly and is intended for download and file distribution. This package is used for Azure Service Fabric deployments. See Install AppDynamics for Azure Service Fabric for instructions.
AppDynamics.Agent.WindowsAppDynamics .NET Core microservices agent for Windows. Recommended for standalone installations. See Install the .NET Core Microservices Agent for Windows for deployment instructions. NOTE: This package does not support .NET Framework, only .NET Core for Windows.

AppDynamics.Agent.Azure.CloudServices

AppDynamics .NET agent for Azure Cloud Services. See Install AppDynamics for Azure Cloud Services.
AppDynamics.Agent.Azure.AppService.Windows

AppDynamics .NET microservices agent for Azure App Service. This package is intended for applications deployed to Azure App Service (Azure Web Apps and Azure API Apps). See Install the AppDynamics .NET Microservices Agent and Install AppDynamics for Azure App Service for instructions.

Resolved Issues

Key
Summary
DOTNET-1215Custom Error Detection failure: Ignore Exception rule does not work until app restarts
DOTNET-2159SQL Server Reporting Services instrumentation with 4.4.x agent is breaking Reports
DOTNET-2224.NET Agent 4.4.x configuration utility failing where .NET Framework 4.0 is not present
DOTNET-2321

4.4.2 Agent cannot instrument the Standalone executable's 32-bit child process

AppDynamics for Azure

  • The AppDynamics for Azure documentation has been moved here.

SAP Agent Monitoring Using AppDynamics

  • Documentation for the new SAP Agent for monitoring using AppDynamics is located here

Standalone Machine Agent and Server Visibility (4.4.3.1214 - May 4, 2018)

Kubernetes Visibility

Kubernetes Visibility extends AppDynamics Docker intelligence to monitor the containers orchestrated by Kubernetes. You can deploy the Standalone Machine Agent as a Kubernetes daemonset. This ensures that every Kubernetes worker node runs the agent, and that the agent collects critical resource metrics from both the node host and the associated Docker containers. See Kubernetes Visibility and AppDynamics APM.

AppDynamics for Docker and Kubernetes

Docker Visibility and Kubernetes Visibility documentation has been moved to AppDynamics Cloud Monitoring.

Server Visibility UI Enhancements

  • The Application Dashboard has a Containers table that shows all containers used by the selected application. Select the application of interest, then click Containers on the left-side menu. 
  • You can now filter the Servers Table and Containers Table based on server tags from AWS, Kubernetes, and other sources.
  • The Container Details window now shows all server tags associated with that container.

Docker Visibility Enhancements 

  • Docker Visibility can now collect the following metrics:
      • CPU > Throttled Time (ms)
      • Memory > Failed Count
      • Memory > Page Major Fault Count
      • Memory > Resident Set Size (MB)
      • Memory > Cache Size  (MB)
      • Container > Memory > Memory Reservation
      • Container > CPU > CPUs
  • The Standalone Machine Agent can now collect Memory and CPU metrics for Docker containers using cgroup data. This method is much faster than using the Docker API (the default metric-collection method). You can enable cgroup metric collection on all platforms except Amazon Linux OS.
    This mode is disabled by default. To enable cgroup metric collection, run the agent with the following command-line option set to true:
         java -Dappdynamics.docker.container.collection.cgroup.enabled=true  -jar machineagent.jar

Resolved Issues 

Key
Summary
SERVER2312In some cases, Machine Agent stops collecting process metrics even after machine/global max thresholds are increased
SERVER-2472calcVolumeFreeAndUsedWithDfCommand=true option for collecting Disk Usage metrics on Linux does not work as documented
SERVER-2586AppDynamics Agents > Machine Agents table does not show all Standalone Machine Agents
SERVER-4374Machine Agent name check is case-sensitive, which prevents some agents from registering with Controller
SERVER-4410

Controller needs to check if Standalone Machine Agent is reporting on Service Availability before purging stale agent

Database Visibility (4.4.3.536 - May 4, 2018)

  • The Database Blocking Sessions Window is now available for Sybase ASE. 

Resolved Issues

Key
Summary
DBMON1189Exception when trying to access Execution Plan on Mongo DB
DBMON-1459

"java.lang.IllegalArgumentException: Malformed \uxxxx encoding" when starting database collector with hardware metrics capture enabled

DBMON-1537

java.lang.ClassCastException thrown during hardware monitoring of RDS

DBMON-3064

collectorStatus shows in DB Collectors REST API as null in 4.4.x Controller version but works fine in 4.3.8.2

4.4.3.9459 (HF1-Controller) Updates

This release introduces HTTPS support for the Enterprise Console, enhancements to Aurora DB support, fixes to the Enterprise Console Controller HA, and improvements to troubleshooting messages and logs. For documentation on Enterprise Console HTTPS, see HTTPS Support for the Enterprise Console. You can find this update in the following:

  • Enterprise Console (Version 4.4.3.9459 – May 9, 2018)
Resolved Issues

 

Key
Summary
ECONSOLE-2827Enterprise Console does not retrieve logs when using Aurora DB

 

ECONSOLE-3082HA failover is enabled and allowed even when replication is broken

 

ECONSOLE-3103HA install fails to honor customized "DB Data Directory" when setting up secondary Controller

 

ECONSOLE-3114

Add-secondary-controller operation missing an incremental option

APMPLAT-2977, APMPLAT-6471Null pointer exception when trying to use reuse node system property
APMPLAT-6417Unlimited Controller node creation when license limit is hit and agent is started with -Dappdynamics.agent.reuse.nodeName=true and -Dappdynamics.agent.reuse.nodeName.prefix=<prefix> parameter
SERVER-3902Standalone Machine Agent lists in Controller UI: Very long load/display times if Controller database has many Orphaned machine agents

 

4.4.3.10005 (HF2) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.10005 – May 18, 2018)
Resolved Issues

 

Key
Summary
ECONSOLE-3080Enhancement to add secondary Controller via incremental and final replication

 

ECONSOLE-3098Controller HA failover job mistakenly starts both primary and secondary Controllers

 

ECONSOLE-3115

The HA Auto Failover Interval is significantly delayed

ECONSOLE-3169

db/lib backup fails when it encounters Linux symbolic links

4.4.3.10393 (HF3) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.10393 – May 25, 2018)
Resolved Issues

 

Key
Summary
DBMON-3193

Unable to view execution plan of specific query types 

ECONSOLE-3101Intermittent HA primary Glassfish availability leads to two active Controllers running

 

ECONSOLE-3204Failover job does not trigger in the case of a network connectivity loss

 

ECONSOLE-3250

Secondary MySQL does not start due to space ID collisions

ECONSOLE-3259Unable to retry or resume failed jobs from checkpoint if the external URL is incorrectly specified
PLATCPS-5140Changes for License Rule serialization of API requests

4.4.3.10393 (HF3-JAVA) Updates 

You can find this update in the following:

  • Java Agent (Version 4.4.3.23530 – June 29, 2018) 
Resolved Issues

Key

Summary

JAVA-3819

Memory leak by adding EUM HTTP header in NettyHttpResponse


4.4.3.10598 (HF4) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.10598 – June 1, 2018)

This release includes support for DB Controller User Password customization through the Enterprise Console UI.

Resolved Issues

 

Key

Summary

ECONSOLE-3297

Add support for Controller password customization using the Enterprise Console

ECONSOLE-3310

Show version number and time information on the About modal

ECONSOLE-3311

Aurora DB Controller upgrade fails with password changes

Security Advisory 2089: SQL Injection within AppDynamics Enterprise Console

Fix for CVE-2018-0225

Special thanks to:

Ricardo Emilio Santos Fajin of Stone Payments Brazil

Oliveira Lima of RealProtect

 

We thank you for working with the AppDynamics team in discovery, and responsible disclosure of this issue.


For customers who require further information on remediation please see: Security Advisory 2089

4.4.3.10728 (HF5) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.10728 – June 8, 2018)

Resolved Issues

 

Key

Summary

PLATCPS-5157

APM license module is present on the license rule UI but with zero units

METADATA-4529

Method MQMB_MetricDataHelper.adjustMetricTimeRange produces corrupted time range

ECONSOLE-3331

Enterprise Console installation fails on Mac due to PlatformRegistry changes

ECONSOLE-3340Enterprise Console fails to capture STDERR from remote commands that exit abnormally
ECONSOLE-3341SaaS Controller upgrade to 4.4.3 fails
APMPLAT-6974ISS App Pools page freezes
APMPLAT-6575Federated backend resolution fails with multiple backends resolving to the same FrendApp

4.4.3.10902 (HF6) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.10902 – June 22, 2018)

Resolved Issues

Key

Summary

ECONSOLE3375

Enterprise Console fails to discover and upgrade Controller if some fields are missing in domain.xml
PLATCPS-5645In some cases, App Agent cannot connect with Controller due to error in license availability check
DASH-2821When displaying APM custom metrics, Custom Dashboard Metric Selection dialog box displays some subtrees incorrectly under Individual Nodes

4.4.3.11348 (HF7) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.11348 – July 8, 2018)
Resolved Issues

Key

Summary

PLATCPS‑4555

Agent availability status constantly changes due to metric cache

4.4.3.11856 (HF8) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.11856 – July 19, 2018)
Resolved Issues
Key Summary 
DBMON-3289DB Agent cannot communicate with Controller after Controller restart
ECONSOLE3417High Availability –  Add secondary controller job fails after the primary controller (which was previously part of a High Availability pair) was upgraded as a single node
ECONSOLE-3486High Availability – Incremental Replication is still susceptible to space ID collisions when running on older Linux platforms


4.4.3.11894 (HF9) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.11894 – July 30, 2018)
Resolved Issues
Key Summary 
BRUM-4037Unable to disable monitoring for BRUM
EUMUI-1767Empty Mobile Apps are visible in the Browser App section

4.4.3.12462 (HF10) Updates

You can find this update in the following:

  • Enterprise Console (Version 4.4.3.12462 – August 14, 2018)
Resolved Issues
Key Summary 
ANALYTICS-8481Backport for ANALYTICS-7959 (Synchronize licensingConfigurations List access)

4.4.4 Updates

You can find this update in the following:

  • .NET Agent (4.4.4.2470 - June 7, 2018)
Enhancements
  • Added support for disableInjectFields in .NET Core applications
Resolved Issues

 

Key

Summary

DOTNET-1304

 

MVC Controller/Area/Action naming convention not working for ASP.NET CORE business transactions

DOTNET-2219

 

System.InvalidProgramException with POCO instrumentation

DOTNET-2295

 

EUM Auto Injection not working for redirect page

DOTNET-2392RequestReflector warning - problem getting Cookies:System.Web.HttpRequestValidationException
DOTNET-2428PlatformNotSupportedException operation is not supported on this platform when analytics is enabled

 

4.4.5 Updates

C++ Agent (4.4.5.0 - May 7, 2018)

  • The following functions are now available for the application context:
    • appd_context_config_set_controller_host
    • appd_context_config_set_controller_port
    • appd_context_config_set_controller_account
    • appd_context_config_set_controller_access_key
    • appd_context_config_set_controller_use_ssl
    • appd_context_config_set_controller_http_proxy_host
    • appd_context_config_set_controller_http_proxy_port
    • appd_context_config_set_controller_http_proxy_username
    • appd_context_config_set_controller_http_proxy_password
    • appd_context_config_set_controller_http_proxy_password_file
    • appd_context_config_set_controller_certificate_file
    • appd_context_config_set_controller_certificate_dir

  • Function added for overriding the exit call time, appd_exitcall_override_time_ms. For more information, see the C/C++ Agent SDK Reference.

 

4.4.6 Updates

C++ Agent (4.4.6.0 - May 17, 2018)

  • This release includes several security fixes.
  • A new function, appd_config_set_flush_metrics_on_shutdown, is now available. For more information, see the C++ SDK Reference.

 

4.4.7 Updates

C++ Agent (4.4.7 - May 25, 2018)

  • Resolved a potential problem with slow transaction checking for a very high number of concurrent requests.

Node.js Agent (4.4.7 - May 19, 2018)

  • This release includes several security fixes.

 

4.4.8 Updates

Node.js Agent (4.4.8 - May 21, 2018)

  • Updated to resolve Windows native artifacts.

4.4.9 Updates

Node.js Agent (4.4.9 - May 25, 2018)

  • Resolves a potential problem with slow transaction checking for a very high number of concurrent requests.

 


  • No labels