On this page:

 

This page describes compatibility mappings between agent and Controller versions. 

About Agent and Controller Compatibility

AppDynamics agents are not backwards compatible with the AppDynamics Controller. The Controller version must be equal to or greater than the versions of any agents connecting to it.

A monitored environment may have agents of different versions deployed in it at a given time, as long as all agents are compatible with the Controller version. However, the oldest agents should be on originating tiers of any business transactions. This ensures that agents on downstream nodes can process the correlation header created by the originating tier.

It's an important point to consider when rolling out agent upgrades—be sure to start upgrading the agents on the nodes of downstream tiers first, and then upgrade the agents on the originating tier nodes last.

Java Agent Compatibility

The 4.3.x Controller supports the following versions of the Java Agent:

For notes on SSL protocol compatibility between versions of the agent and Controller, see SSL Compatibility Matrix for App Agent for Java - Controller

.NET Agent Compatibility 

The 4.3.x Controller supports the following versions of the App Agent for .NET:

PHP Agent Compatibility

The 4.3.x Controller supports the following versions of the :

Node.js Agent Compatibility

The 4.3.x Controller supports the following versions of the :

Python Agent Compatibility

The 4.3 Controller support the following versions of the Python Agent:

Web Server Agent Compatibility

The 4.3.x Controller supports the following versions of the Web Server Agent:

C / C++ Agent Compatibility

The 4.3.x Controller supports the following versions of the C/C++ SDK:

Database Agent Compatibility

The 4.3.x Controller supports version 4.3.x and higher of the Database Agent.

AppDynamics for Databases Compatibility

The 4.3.x Controller supports the following versions of AppDynamics for Databases:

Note: AppDynamics for Databases version 2.7.4 is required for AppDynamics for Databases to correlate with the App Agent for PHP.

Standalone Machine Agent Compatibility

The 4.3.x Controller supports the following versions of the Standalone Machine Agent:

SSL Compatibility between Java Agent and Controller

The default protocol used by the Controller is TLSv1.2.

For the Java Agent, the default protocols are:

The default SSL protocols for the Controller and agent changed in 3.8.x. See Agent - Controller Compatibility Matrix in the 3.8 documentation for SSL compatibility information for previous versions. 

Introduction of New Agent Features

Even when new and old agents are supported by the same up-to-date Controller, new functionality introduced by later agents is not available on the older agents.

Information about when an agent feature was introduced is documented in the New and Enhanced Features section for a new major release (such as 4.3) and <minor_release_number> Updates sections for minor releases in the release notes.

For example, support for percentile metrics was introduced for the .NET agent in 4.0, as documented in the .NET Agent Updates section under New and Enhanced Features in 4.0 in the Release Notes