Discussion Feed

Hello Community! We are very excited to announce a major update with the release of AppDynamics v4.5 [shipped July 11, 2018]. The on-going adoption of microservice architectures and the increasing use of asynchronous application frameworks make it easier than ever to build highly scalable, resilient applications. Each application node may be simpler, but the overall architecture continues to increase in complexity. In AppDynamics v4.5, we introduce significant new support for asynchronous frameworks, new capabilities in containerization, and additional support for myriad Cloud platforms.   Our release highlights will guide you through the newest features and capabilities.   You'll notice  in the grid that each feature enhancement identifies the most interested or impacted users in your organization. Check out the highlights >> ... View more

In AppDynamics version 4.5, we tackled a multitude of product issues in order to create an improved customer experience. Below is a list of key issues that we resolved:    Duration settings for XLM synthetic sessions are in seconds, but should be in milliseconds (ANALYTICS-7554) DB Agent 4.4.2 fails to start with SQL Server collector when Windows authentication is enabled (DBMON-2953) MSSQL Collector stops reporting data after 9 minutes (DBMON-2977) Application search under Roles displays blank screen after scrolling (PLATUI-346) When an EUM app's new metric limits are reached, no new metrics are created, and data for existing metrics are not recorded (BRUM-3571) The JavaScript Agent is freezing a single-page application when the application triggers a search event (BRUM-3551) Regular expressions including ampersands aren't working (EUMUI-1574) Mobile sessions are not loading for some users (EUMUI-1703) The start time is incorrect for synthetic sessions where the HAR doesn't have a base page (SYNTH-3373) Some internal errors are being reported as timeouts (SYNTH-2287) Machine agent is not reporting processes, network, and volumes when running in Container (SERVER-2605) Hierarchy name check is case-sensitive, which prevents Standalone Machine Agent registration (SERVER-4369) Service Availability configurations on agent host get deleted when machine is considered stale and marked for deletion (SERVER-4412) License > Account Usage does not show Service Availability license usage (SERVER-4588) Hierarchy name check is case-sensitive, which prevents Standalone Machine Agent registration (SERVER-4369) Intermittent HA primary Glassfish availability leads to two active controllers running (ECONSOLE-2936) Failover job does not trigger (ECONSOLE-3238) Secondary MySQL does not start due to space ID collisions (ECONSOLE-3220) Controller stop operation fails when service is in STOP_PENDING (ECONSOLE-3274) UI display historical nodes (APMPLAT-3610) Copy REST URL in metric browser broken (APMPLAT-6800) Error response after copying/pasting REST URL from Metric Browser (APMPLAT-6926) NPE thrown when trying to get Destination type (JMS) and disabling interceptor (JAVA-3190) Memory leak when adding EUM http header in NettyHttpResponse (JAVA-3819) AppAgent 4.4.x version does not start with JDK 1.9 as JRE runtime version (JAVA-3214) Auto node naming is not working in Service Fabric cluster for .NET Core (DOTNET-2443) QueueTask intermittent instrumentation issue when ReJIT is on (DOTNET-2420) PHP crashes when making a cURL request (DLNATIVE-1579) PHP crashes when trying to destruct a CurlHandleInfo on curl_close (DLNATIVE-1521) PHP crashes when trying to access PDO handle that does not exist in the registry (DLNATIVE-1520) PHP crashes when cleaning up cURL headers (DLNATIVE-1501)   A comprehensive list of resolved issues organized by product area is available in our 4.5 Complete Release Notes   4.5 Release Highlights will also guide you through the newest 4.5 features and capabilities. ... View more

  Today we announce a major update with the release of AppDynamics v4.5. The on-going adoption of microservice architectures and the increasing use of asynchronous application frameworks make it easier than ever to build highly scalable, resilient applications. Each application node may be simpler, but the overall architecture continues to increase in complexity. In AppDynamics v4.5, we introduce significant new support for asynchronous frameworks, new capabilities in containerization, and additional support for myriad Cloud platforms.     Key Highlights Take advantage of 4.5 Language Agents (e.g., Java, .NET, Node.js) now without upgrading your Controller (requires Controller version 4.4.1+). Accelerated diagnosis and issue resolution with Snapshot Correlation, Network Visibility, and the new Snapshot Waterfall Viewer: Show the impact of Business Transactions on the database Identify network issues with Network Visibility correlated to the Business Transaction Diagnose code-level issues faster with the improved snapshot viewer Navigate effortlessly between related processing activity segments Understand the impact of external dependencies on the Waterfall Unified overview of all data collectors within the snapshot More secure automation than ever with   token-based authentication for REST APIs   — no more passwords embedded in scripts. Enhanced real-time insights into business performance with new out of the box dashboards and critical metrics for Business Journeys, plus added time zone support for Experience Level Management (XLM). New support for .NET Core on Linux via our SDK.  Couchbase NoSQL support and even more database monitoring improvements. Bolstered Cloud capabilities  — additional monitoring support for OpenShift and Pivotal Cloud Foundry (PCF). PCF service broker tile has been revamped for tighter integration with PCF, including full infrastructure KPI metrics and an out of the box dashboard for a single view of system health and availability. Fully integrated Docker/Kubernetes container monitoring is now available for OpenShift v3. New IoT capabilities — trace an API service request from an IoT device to the AppDynamics Business Transaction with IoT BT Correlation, available through REST APIs and IoT SDKs. Mobile SDKs offer improved support for hybrid applications mixing web views with native code  —  follow the end-to-end story of your user’s journey. Enhanced GDPR Audit capabilities — new dashboard displays a unified view of all data collection across AppDynamics product lines. Cheers, Tom Rabaut & AppDynamics Product Management These release highlights will guide you through the newest features and capabilities. Notice in the grid below each feature enhancement identifies most interested or impacted users.   Product Feature Enhancement User and Performance Analyst Admin and Implementer Developer Application Performance  Support for .NET Core for Linux SDK     ✓   ✓ Snapshot Waterfall Viewer   ✓     Business Transaction and Backend Timing Enhancements   ✓   ✓   ✓ Out of the Box Instrumentation for IBM BPM   ✓   ✓   Out of the Box Instrumentation for Spring Batch Framework     ✓   Additional Java Framework Support     ✓   Language Agent Compatibility     ✓     End User   Monitoring    Custom Virtual Page API for SPA2 Monitoring   ✓     ✓ Faster Root Cause Analysis for Browser RUM   ✓     ✓ Code Issues Dashboard for Mobile   ✓     ✓ Support For Hybrid Mobile Apps and Web Views   ✓     ✓ IoT Business Transaction Correlation through REST APIs and IoT SDKs ✓     ✓ Infrastructure    Visibility           Generic Cluster Support ✓ ✓   Support for Couchbase ✓ ✓ ✓ Custom Query Metrics Enhancements ✓     Generic Snapshot Correlation ✓     Dynamic Monitoring Mode (DMM) for all Docker Visibility Metrics ✓  ✓ ✓ Additional Docker Metrics ✓   ✓ ✓ Support for OpenShift      ✓   ✓ Pivotal Cloud Foundry (PCF) KPI Dashboard    ✓   ✓   ✓ Network Visibility for Docker Containers ✓   ✓   ✓ Cross Application Flows ✓     Transaction Snapshot Support for Network Analysis ✓     Business Performance      Business Journey Authoring Enhancements ✓     Visibility into XLM Data and XLM Time Zone Support ✓     Export Improvements ✓     Business Metrics Enhancements ✓     Additional ADQL Clauses and Functions ✓     Widget Enhancements   ✓     Platform Comprehensive Audit Logging and Reports   ✓   Data Privacy and Collection   ✓   Support for Major-Version Upgrades for the Enterprise Console   ✓   Rest API Authentication   ✓   Create Events Permission   ✓   Resolved Issues As part of 4.5, we resolved several issues, including: Service Availability configurations on agent host get deleted when machine is considered stale and marked for deletion (SERVER-4412) Secondary MySQL does not start due to space ID collisions (ECONSOLE-3220) Failover Job does not trigger (ECONSOLE-3238) Error response after copying/pasting REST URL from Metric Browser (APMPLAT-6926) When an EUM app's new metric limits are reached, no new metrics are created, and data for existing metrics are not recorded (BRUM-3571) A list of key resolved issues is available here. All resolved issues are listed in the Complete Release Notes   Ask a question about the release   Complete Release Notes are now available   Additional Resources   Support for .NET Core for Linux SDK Gain visibility into your .NET Core applications and optimize business performance using the .NET Core for Linux SDK. With the SDK, you’ll have cross-application support and can monitor the migration of applications to microservice architectures. The SDK works with LibAgent natively on Linux for a more integrated Linux experience and is supported on CentOS7 and Ubuntu 14.0.4 with a NuGet package deployment. Full documentation   Snapshot Waterfall Viewer Identify delays due to backend responses using the Waterfall View in the snapshot viewer, which now shows relationships between segments, includes external backends as segments and shows resource timing for business transactions. By following the thread end-to-end, you can see where time was spent processing a business transaction and troubleshoot those specific areas. A centralized view of MIDC displays all data collectors on one screen so you can access details faster. Full documentation   Business Transaction and Backend Timing Enhancements Business transaction and backend timings reflect response times for supported asynchronous entry and backend calls so you can get a more accurate reading of the processing time. Full documentation   Out of the Box Instrumentation for IBM BPM Out-of-the-box configuration provides Business Transaction discovery and naming along with data collectors to allow users to stitch together business transactions captured from the BPM BPM product into Business Journeys so you can track the technical and business performance of your BPM processes. Full documentation   Out of the Box Instrumentation for Spring Batch Framework Proactively predict and prevent issues while a batch is running instead of catching them after the batch has completed. If you use Spring Batch for batch processing, the Java agent will now create Business Transactions named after the job, step, and tasklet, and correlate chunks passed across thread boundaries or process boundaries (via JMS). Full documentation   Additional Java Framework and Backend Support We have added support for several Java frameworks, including Axon, Vert.x 3.5, Spring integration 4, JAX-RS async client, and Kafka correlation, to ensure monitoring capabilities are as comprehensive as possible. Full documentation   Language Agent Compatibility Take advantage of 4.5 Language Agent features without waiting for a 4.5 controller upgrade. 4.5 is the first release where the newer agents can work against older controllers (4.4.1+), bringing increased flexibility to your upgrade schedules.  Full documentation   Custom Virtual Page API for SPA2 Monitoring AppDynamics 4.4.3 added support for many JavaScript frameworks like React and Angular 4+. This version adds an API you can call to report custom virtual pages that aren't detected automatically. Full documentation   Faster Root Cause Analysis for Browser RUM The Browser Analyze screen has several improvements to help you under problems faster: a graph of end-user response time percentiles over time to understand how many users are affected by an issue, a Performance Impact score for each Page, Browser, and Country to narrow down on problem areas, and Resource Timing snapshots for all page views to get to the root-cause. Full documentation   Code Issues Dashboard for Mobile The Code Issues Dashboard provides visibility into non-crash issues that still impact customers, like application hangs, slow UI, and caught exceptions. You can look at user journeys that result in code issues to easily reproduce problems and view full stack traces and code issue trends to proactively improve end user experience. Having this information available in one comprehensive dashboard allows you to resolve issues faster and provide a better customer experience. Full documentation   Support for Hybrid Mobile Apps and Web Views We’re excited to offer monitoring support for Cordova-based applications and for WebViews running in native iOS and Android applications using a combination of our MRUM and BRUM agents so you can collect meaningful and actionable metrics. Full documentation   IoT Business Transaction Correlation through REST APIs and IoT SDKs Correlate edge application events to your underlying backend applications using the IoT REST API and SDK for more extensive visibility into your IoT devices. Business transaction correlations will show up as part of the Activity Stream for each device through its entire life so you can better understand how your application is performing. Full documentation   Generic Cluster Support This release provides enhanced support for database clusters, including Master/Slave technologies and sharded architectures. You can define a single collector configuration to monitor multiple database instances, treating them like one entity, allowing for a better visualization within the UI . Full documentation   Support for Couchbase Use AppDynamics Database Visibility to remotely monitor your Couchbase clusters without any component or code modifications. Monitor N1QL queries on all database activity and review historical time-series graphs of time spent in Couchbase (supplemented by underlying database-specific metrics) to proactively identify and resolve performance issues. Full documentation   Custom Query Metrics Enhancements Scale your custom queries for deeper insight into your database with several new features, like scheduling and bulk add activities. Using the new Custom Metrics tab in the Dashboard view, you’ll see data trends faster without having to create custom dashboards. Test custom queries before creating them, saving you time debugging errors later. These are just a few of the recent additions! Full documentation   Generic Snapshot Correlation With generic snapshot correlation, we’ll attempt to match and tag business transactions and snapshot identifiers to database visibility data to provide a better integration across your entire solution. The new Database Queries tab on the Business Transaction dashboard displays correlated queries and database data directly in your APM Dashboard for a more comprehensive dataset. Full documentation      Dynamic Monitoring Mode (DMM) for all Docker Visibility Metrics Turn on Dynamic Monitoring Mode (DMM) for a richer set of metrics when diagnosing a specific issue, such as spikes on CPU load. You have the flexibility of configuring individual agents to collect KPI metrics, KPI and Diagnostic metrics, or all available metrics to ensure you’re capturing the most important information while conserving metric bandwidth. Full documentation   Additional Docker Metrics You can enable additional Docker metrics from the DMM drop-down menu to examine how your containers are performing and diagnose issues as needed. Newly available metrics include CPU %Busy scaled, incoming/outgoing KB and KB/sec, incoming/outgoing packets and packets dropped, and disk metrics for certain platforms. Full documentation   Support for OpenShift Server Visibility's Integrated Docker Visibility is available for applications deployed using OpenShift v3. You can collect performance data from Openshift clusters using the Machine Agent and display Kubernetes metadata and tags in the Controller. Full documentation   Pivotal Cloud Foundry (PCF) KPI Dashboard The PCF KPI Dashboard enables you to monitor the performance of a PCF platform on which an AppDynamics tile is running. This dashboard uses a set of custom Health Rules and metrics to visualize PCF performance metrics and capacity-scaling indicators in a single location. Full documentation   Network Visibility for Docker Containers Monitor traffic for application nodes running inside Docker containers with the Network Agent so you can collect detailed metrics, identify areas where network issues are occuring, and identify root cause of performance issues. Full documentation   Cross Application Flows Drill down into the Network Dashboard to see TCP metrics for calls across applications and take advantage of an updated visual convention that better represents TCP endpoints when analyzing a flowmap . Full documentation   Transaction Snapshot Support for Network Analysis Troubleshoot network issues more efficiently by getting network context directly from transaction snapshots. You can right-click on a flow in the Snapshot Overview and select “View Network Metrics” to see performance-impacting events and possible correlating factors. Full documentation   Business Journey Authoring Enhancements You now have immediate access to the representations of business journeys and corresponding milestones with new out of the box dashboards . You can use out of the box critical metrics like average end-to-end time to create health rules and understand how your business is performing. We’ve also added a single-click “Search” option to the Business Journey dashboard so you can access relevant data faster and reduce MTTR. Full documentation   Visibility into XLM data and XLM Time Zone Support Perform compliance calculations and generate reports in your desired time zone instead of experience and service levels in UTC. You can also export XLM reports containing compliance and events data in CSV format for easy reporting. Full documentation   Export Improvements We've expanded the analytics export capability by increasing the number of rows that can be exported to CSV to 65,000 in order to match standard file sizes and present you with more information at once. Full documentation   Business Metrics Enhancements The Metric Listing page has been updated to provide a more intuitive experience. Click on a metric name to open a pre-populated Metric Browser, select multiple metrics to view them together in the Metric Browser for comparison, or add metrics to the dashboard from the Metric Listing page. The page now displays the underlying ADQL query for metrics, making it easy to see what a particular metric represents and how it is calculated. You can also enable and disable multiple metrics simultaneously from the toolbar. Full documentation   Additional ADQL Clauses and Functions New ADQL operators empower more sophisticated aggregation and filtering. Use the HAVING clause to return rows filtered on aggregated conditions  (e.g., values with an average response time greater than 30 ms), or totalResultsCount() to return the total count of events before being divided up by different dimensions. For querying specific points in time not tied to the UI based time picker, use the  SINCE... and UNTIL.. clauses (e.g,. transactions on 5/18/18).  Full documentation on the HAVING clause , totalResultsCount() , and SINCE...and UNTIL clauses   Widget Enhancements Enhancements to our widgets options enable more precise widget customization to create more visually appealing dashboards and make it easier to interpret trends in your event data. You can edit widgets in less time with the new multi-widget editing option. We’ve added a log axis for time series widgets to compare values with differences in the order of magnitudes. You can also hide legends options that are unnecessary. Our numeric (univariate) widgets can now display the level of numeric specificity in numeric widgets to see the information that’s most important to you, and a trailing period value comparison indicator makes it easy to understand how your key metrics are changing.  Full documentation on visualizing analytics , creating widgets , and widget operations   Comprehensive Audit Logging and Reports Our enhanced audit report makes it easier to see and filter details about state changes, including the exact change, the previous state, and who performed the change, for a number of different entities. You can also export the audit report as a CSV or JSON so you can slice-and-dice data based on what you’re most interested in analyzing. Full documentation   Data Privacy and Collection We’ve made several additions to make data collection details more accessible. The Data Collection Dashboard lets you view all of your current data privacy collection settings in a unified view, making it easier to keep track of all of your configurations. For regulatory purposes, a Data Collection Privacy dialog will appear when you are configuring parts of the AppDynamic product to remind you that the change could impact the collection of regulated information. Full documentation on the Data Collection Dashboard and Data Collection Privacy Dialog   Support for Major-Version Upgrades for the Enterprise Console You can now manage and upgrade multiple Controllers and Events Services on different versions from one Enterprise Console, providing more flexibility when upgrading production, UT, staging, and dev platform services. Full documentation   Rest API Authentication Maximize your security profile in the form of token-based authentication. You can create and use API Clients to provide secure access to the Controller through REST API calls, which use OAuth token-based authentication instead of credentials. These signed or encrypted tokens can be refreshed or revoked at any time. Full documentation   Create Events Permission We’re supporting more granular role creation across product lines to provide better consistency and control over who can complete different tasks across the AppDynamics product line. In 4.5, you can assign the new Create Events permission to custom roles so employees can create custom events without needing administrative rights. Full documentation   Ask a question  about the release   Complete Release Notes   are now available.   Additional Resources Monitoring Cloud Applications AWS and AppDynamics APM Deploy AppDynamics for Azure Pivotal Cloud Foundry Download Essential Components AppDynamics Upgrade Checklist For Any Release ... View more

To make sure you complete all the tasks necessary for upgrading your EUM Server, Agents, and SDKs after a release, we recommend following the instructions in our upgrade checklist. This guide is not release-specific and can be referenced for any release.   Preparation Review the Product Announcements and Alerts page  for details on any intermediate versions between the current version of your instance and the version you are targeting. Review the compatibility matrix in our Community and documentation for various components of the AppDynamics environment. Review our EUM component compatibility article for details specific to EUM. Review the Mobile Agent Version and Deployment Support Matrix to determine the minimum versions of the Controller and EUM Server required for supporting the latest features of the Mobile Agents. For platforms where the Controller, EUM Server, and Events Service are being upgraded at the same time: The Controller version should be <= the Events Service version and you should perform the upgrades in a specific order. See Upgrade Platform Components for details on the upgrade order and instructions on upgrading the Events Service, which should be upgraded before the EUM Server .   Upgrading the EUM Server (on-premises only) The EUM Server version should be <= Events Service version Ensure the key matches between the Events Service, EUM Server, and Controller: analytics.accountAccessKey == ad.accountmanager.key.eum ==appdynamics.es.eum.key . For instructions on configuring EUM connection settings, see: Connect to the Events Service See Upgrade the Production EUM Server for step-by-step instructions. In addition to upgrading your server, you will need to follow the instructions on migrating your EUM data. For the 4.5 production EUM Server, the EUM MySQL database has been moved from the Controller host machine to the EUM Server host machine. Tip! If your are on a production EUM Server 4.3 or earlier, follow the additional steps called out in the documentation linked above (steps B, F, and G). After upgrading your EUM Server, you can upgrade your Controller following the steps outlined here .   Upgrading the EUM Agents/SDKs Upgrade the JavaScript Agent Tip! If you are a 4.4 SaaS customer and have an EUM license, we recommend upgrading to the latest JavaScript Agent. See: Upgrade the JavaScript Agent Upgrade the Mobile Agents See Upgrade iOS SDK for step-by-step instructions on upgrading manually or using CocoaPods. See Upgrade the Android Mobile Agent for step-by-step instructions on upgrading the Android SDK in your app. See Upgrade the Xamarin Agent for step-by-step instructions on upgrading the Xamarin Agent package in your app. Upgrade the IoT SDKs See Upgrade the IoT C++ SDK for step-by-step instructions. See Upgrade the IoT Java SDK for step-by-step instructions.   Instructions for upgrading other AppDynamics components are available in our general  Release Upgrade Checklist.   Last Updated: 3/15/19 ... View more

A complete checklist and compatibility matrices for Controller, Agents, and platform components   NOTE: The information in this article is not release-specific. You can reference it for any release.   Before you upgrade your Controller, you’ll want to be familiar with how the new Controller version you’re targeting interacts with the Agents in your environment.    How does the version compatibility for Controllers and component Agents map to your environment? Are there interim versions you need to consider? Do you know where to find reference information and instructions so you can upgrade those components successfully?   To make sure you know the steps to follow for a successful release upgrade, we recommend starting with this article and then following the instructions in our upgrade checklists (links available below).   Table of Contents Be sure to review Product Announcements and Alerts Agent-to-Controller Version Compatibility  Database Agent-to-Controller Version Compatibility Other Compatibility Considerations:  On-premises, Backward Compatibility How do you find your Controller Version? Next Steps: Upgrade Checklists for other Components     Be sure to review Before upgrading any component, we recommend you review available information about version compatibility between the target Controller and all the Agents relevant to your environment:   ✓ Product Announcements and Alerts ✓ Version Compatibility Matrices ✓ Compendium of Upgrade Checklist Articles   Product Announcements and Alerts Review the Product Announcements and Alerts page to discover and understand the details of upgrading any intermediate versions between your current Controller version and the one you’re targeting.   Agent-to-Controller Version Compatibility Review the Agent-to-Controller and Database Agent-to-Controller compatibility grids just below for various components of the AppDynamics environment.    NOTE : For complete details about component compatibility, see our Community and technical documentation . NOTE : See the following section for Database Agent-to-Controller Compatibility AGENTS SUPPORTED  CONTROLLER  VERSIONS v4.3 v4.4 v4.5 v20.3 - future releases Analytics The Analytics Agent’s version should be less than or equal to the Controller’s version, and it should also be less than or equal to Event Service version Apache Web Server The Apache Web Server Agent’s version should be less than or equal to the Controller’s version Java 4.x - 4.3 4.4.1 - 20.x (1) 4.5 - 20.x  (1)  4.4 - 20.x  (1)(2) JavaScript (ADRUM)  The JavaScript Agent’s (ADRUM) version should be less than or equal to the EUM Server version Machine 4.x - 4.3 4.4.1 - 20.x  (1) 4.5 - 20.x  (1) 4.4 - 20.x (1)(2) .NET 4.x - 4.3 4.4.1 - 20.x  (1) 4.5 - 20.x  (1) 4.4 - 20.x  (1)(2) (1) Controller version supports through the most recent released Agent version (2) Controller version does not support Agent version 4.1   Database Agent-to-Controller Version Compatibility NOTE : The AppDynamics DB Agent isn’t backward compatible. Its version should be less than or equal to the Controller version.   Supported Controller Versions Controller Versions v4.3 v4.4 v4.5 v20.3 - future releases DB Agent 4.1-4.3 (1) 4.1-4.4  (1) 4.1-4.5  (1) 4.1 - 20.x (1)(2) (1) Controller version supports through the most recent released Database Agent version (2)  DB Agent is only compatible up to its corresponding Controller version   Other Compatibility Considerations On-premises Compatibility  Things to keep in mind when you have an on-premises deployment:   The Controller version should be less than or equal to the EUM Server version, and should also be less than or equal to Events Service version The EUM Server version should be less than or equal to the Events Service version The Java Script Agent version should be less than or equal to the EUM Server's version   Agent Backward Compatibility Starting with release v.4.5x, backward compatibility is supported on the following Agents: Java .NET Node.js PHP Python Go SDK C/C++   How do you determine your Controller version? On your Controller’s Home page, click the Settings gear on the upper right. Then click About AppDynamics just above the logout option. Home > Overview > Settings > then click About AppDynamics   A dialog box with the Controller’s current version and build will appear "About AppDynamics” dialog box, headed by the Controller version and build     Next Steps: Checklists for upgrading each component After following the recommendations in this article, refer to the relevant upgrade checklists for each type of AppDynamics component:    NOTE: These guides are not release-specific and can be referenced for any release. Upgrading Platform Components Upgrading Machine Agents Upgrading Java Agents Upgrading .NET Agents Upgrading Dynamic Language Agents Upgrading Analytics Agents Upgrading Database Agents Upgrading EUM Servers, Agents, and SDKs     Last Updated: 7/20/20 ... View more

To make sure you complete all the tasks necessary for upgrading your Analytics Agents after a release, we recommend following the instructions in our upgrade checklist. This guide is not release-specific and can be referenced for any release.   Preparation Review the Product Announcements and Alerts page  for details on any intermediate versions between the current version of your instance and the version you are targeting. Review the compatibility matrix in our Community and technical documentation for various components of the AppDynamics environment.   Upgrading Analytics Agents Tip! The Analytics Agent, Events Service and Controller versions should be compatible: The Analytics Agent version should <= the Events Service version. Analytics Agent Version <= Controller Server version. Tip! You should maintain a copy of the controller.xml file in addition to the analytics-agent.properties , job directory, and watermark folder. See Upgrade Analytics Agent for step-by-step instructions. If you are running the Analytics Agent through the Machine Agent, see Upgrade the Machine Agent for instructions. In the event of a failure, follow the troubleshooting steps outlined here .   Instructions for upgrading other AppDynamics components are available in our general Release Upgrade Checklist ... View more

To make sure you complete all the tasks necessary for upgrading your dynamic language agents after a release, we recommend following the instructions in our upgrade checklist. This guide is not release-specific and can be referenced for any release.   Preparation Review the Product Announcements and Alerts page  for details on any intermediate versions between the current version of your instance and the version you are targeting. Review the compatibility matrix in our  Community  and  technical documentation  for various components of the AppDynamics environment.   Upgrading Dynamic Language Agents Starting in release 4.5, Language Agents are automatically backward-compatible with any 4.4.1+  Controller, so you can upgrade your agent while retaining your 4.4.1+ Controller. If your Controller is older than 4.4.1, you must upgrade your Controller before upgrading your Language Agent. Review the Agent/Controller compatibility matrix for compatibility mappings between Language Agent and Controller versions.  Tip! Upgrade agents first on downstream tiers and then on upstream tiers to ensure a successful correlation. Tip! If you are upgrading multiple agents in your monitored environment, upgrade the agents for the tiers on which business transactions originate last. See Upgrade the PHP Agent for step-by-step instructions. See Upgrade the Python Agent for step-by-step instructions. See Upgrade the Apache Agent for step-by-step instructions. See Upgrade the Node.js Agent for step-by-step instructions. In the event of a failure, uninstall the new agent version and reinstall the older version.   Instructions for upgrading other AppDynamics components are available in our general Release Upgrade Checklist   ... View more

Release Upgrade Checklist for .NET Agents   To make sure you complete all the tasks necessary for upgrading .NET Agents after a release, we recommend following the upgrade checklist instructions below.    NOTE : The information in this article is not release-specific. You can reference it for any release   Table of Contents Prepare to upgrade your .NET Agents Plan your .NET Agent upgrade Troubleshooting Additional Resources   Prepare to upgrade your .NET Agents Review the Product Announcements and Alerts page for details on any intermediate versions between the current version of your instance and the version you are targeting. Review either of the following to confirm the compatibility of the various components of the AppDynamics environment: Knowledge Base article: How do I get started with upgrading my AppDynamics components for any release? , especially the component compatibility matrix Technical documentation: Agent and Controller Compatibility   Plan your .NET Agent upgrade Please note that the .NET agent can reference either the .NET Agent or the .NET Microservices Agent—each a distinct agent with its own use and installation process.  .NET Agent Use : Monitors IIS applications Windows services Prerequisites : See Supported Controller Versions/.NET Agent compatibility matrix below  Installation : See the install document for installation procedure Microservices Agent Use : For applications created with .NET core Prerequisites : See .NET Microservices Agent documentation Installation : Download the NuGET package   Review the Agent/Controller compatibility matrix for compatibility mappings between agents and Controller versions. Supported Controller Versions v4.3 v4.4 v4.5 v20.3 - future releases .NET Agents 4.x - 4.3 4.4.1 - 20.x (1) 4.5 - 20.x (1)  4.4 - 20.x (1)(2) (1) Controller version supports through the most recent released Agent version (2) Controller version does not support Agent version 4.1   Starting in release 4.5, .NET agents are automatically backward-compatible with any 4.4.1+ Controller, so you can upgrade your agent while retaining your 4.4.1+ Controller. NOTE : If your Controller is older than 4.4.1, you must upgrade it before upgrading your .NET agent. To ensure a successful correlation, upgrade agents on downstream tiers first, followed by the upstream tiers. If you’re upgrading multiple agents in your monitored environment, upgrade the agents for the tiers on which business transactions are originated last. See the following as appropriate for step-by-step upgrade instructions: Upgrade the .NET Agent for Linux Upgrade the .NET Agent for Windows See Upgrade AppDynamics.Windows Azure NuGet Package if you are using the AppDynamics.WindowsAzure NuGet package to monitor your Azure solutions. See Install the AppDynamics Azure Site Extension for .NET for instructions for both minor and major releases.    Troubleshooting If the agent installation fails, it may be due to configurations in your environment. Follow the Troubleshoot for .NET Agent Issues to address installation issues.    If necessary, uninstall the new version and reinstall the older version.   Additional Resources Instructions for upgrading other AppDynamics components are available in our general How do I get started with upgrading AppDynamics components for any release?  article. ... View more

Your ticket will close after 14 U.S. PST business days. We will reach out to you during that time period to see if you are still encountering issues and need assistance.     How do I create a follow-up ticket if my ticket was closed? Open your closed support ticket and click the “Create a follow-up” link at the bottom of the ticket. See the screenshot below for reference. Do: Reply back to the Support Engineers as soon as possible with additional information or a status update. Provide real-time update or additional information on your issue as its unfolding. Keep up a two-way dialogue with your Support Engineer to better assist in timely or quick resolution. It’s easier to troubleshoot as close to the incident as possible. Don’t Don’t open a support ticket and abandon it. We want to help you resolve critical issues! Avoid ambiguous language in your responses - provide specific errors and screenshots when appropriate. Don’t open duplicate tickets because this will make it more difficult for us to keep track of your issue and respond quickly. Related Resources Customer Support Guide ... View more