Application Performance Monitoring Tools

The supported APM Tools are:

1. AppDynamics (Version 21.11.0)
2. New Relic (Agent version 9.7.1)

AppDynamics

AppDynamics is an application performance monitoring tool that captures the performance metrics of applications. AppDynamics .Net Agent is the component that is used to instrument .NET process and capture the metrics from .NET based applications. 

By default, both VSP and AppDynamics use the same environment variables listed in table below. Follow the steps mentioned in the following sections to overcome this.

Configuration on .NET Application

1. Install VSP Probe
2. Install App Dynamic Agent by following the below article:  https://docs.appdynamics.com/21.4/en/application-monitoring/install-app-server-agents/net-agent/install-the-net-agent-for-windows 
3. After installation, remove the below system-level environmental variables. These environmental variables are configured by AppDynamics Installer
   
   NOTE

   Make a note of the deleted system-level environmental variables and their values. If VSP is un-installed, these variables need to be added again for AppDynamics to function as expected

   
   

   

   
   

4. Add the below values as System variables
   1. .NET 64-bit Application
      TextText

      VSP_AdditionalProfiler_x64_Path=C:\Program Files\AppDynamics\AppDynamics .NET Agent\AppDynamics.Profiler_x64.dll
      VSP_AdditionalProfiler_CLSID=AppDynamics.AgentProfiler
      

   2. .NET 32-bit Application
      TextText

      VSP_AdditionalProfiler_x86_Path=C:\Program Files\AppDynamics\AppDynamics .NET Agent\AppDynamics.Profiler_x86.dll
      VSP_AdditionalProfiler_CLSID=AppDynamics.AgentProfiler
      

5. Restart IIS server

Configuration on .NET Core Application

1. Download the NuGet package from the link: https://www.nuget.org/packages/AppDynamics.Agent.Distrib.Micro.Windows/ and extract the downloaded file
2. Navigate to the tools directory and  copy the files in that directory  to the target system. Place them in any directory. Example: C:\<foldername>
3. Install VSP Probe
4. Install App Dynamic Agent using the article:  https://docs.appdynamics.com/21.4/en/application-monitoring/install-app-server-agents/net-agent/install-the-net-agent-for-windows
5. After installation, remove the below system-level environmental variables. These environmental variables are configured by AppDynamics Installer
   
   NOTE

   Make a note of the deleted system-level environmental variables and their values. If VSP is un-installed, these variables need to be added again for AppDynamics to function as expected

   
   

   
   

   

   
   

6. Add the below values as System variables
   1. .NET Core 64-bit Application

      VSP_AdditionalProfilerCore_x64_Path=C:\<foldername>\AppDynamics.Profiler_x64.dll
      VSP_AdditionalProfilerCore_CLSID={39AEABC1-56A5-405F-B8E7-C3668490DB4A}

      1. Restart IIS server
      2. The file AppDyanmicsConfig.json can be used to update the AppDynamics Controller information. It is retrieved from the AppDynamics account
   2. .NET Core 32-bit Application

      VSP_AdditionalProfilerCore_x86_Path=C:\<foldername>\AppDynamics.Profiler_x86.dll
      VSP_AdditionalProfilerCore_CLSID={39AEABC1-56A5-405F-B8E7-C3668490DB4A}

      1. Restart IIS server

New Relic

Configuration on .NET/.NET Core Application

1. Install VSP Probe
2. Install New Relic Agent using the article:  https://docs.newrelic.com/docs/agents/net-agent/configuration/net-agent-configuration/
3. After installation, remove the below system-level environmental variable CORECLR_PROFILER. This environmental variable is configured by New Relic Installer
4. Remove the below system-level environmental variables using the Registry Editor. Navigate to HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > Services > WAS > Environment. These environmental variables are configured by New Relic Installer
   TextText

   COR_ENABLE_PROFILING=1
   COR_PROFILER={71DA0A04-7777-4EC6-9643-7D28B46A8A41}
   CORECLR_ENABLE_PROFILING=1
   CORECLR_PROFILER={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
   CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\
   NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent\

   
   
5. Add the below values as System Environment variables in the Registry Editor. Navigate to HKEY_LOCAL_MACHINE > SYSTEM > CurrentControlSet > Services > WAS > Environment

   VSP_AdditionalProfiler_CLSID={71DA0A04-7777-4EC6-9643-7D28B46A8A41}
   VSP_AdditionalProfilerCore_CLSID={36032161-FFC0-4B61-B559-F6C5D41BAE5A}
   CORECLR_NEWRELIC_HOME=C:\ProgramData\New Relic\.NET Agent\
   NEWRELIC_INSTALL_PATH=C:\Program Files\New Relic\.NET Agent\
   VSP_AdditionalProfilerCore_x64_Path=C:\Program Files\New Relic\.NET Agent\netframework\NewRelic.Profiler.dll
   VSP_AdditionalProfilerCore_x86_Path=C:\Program Files\New Relic\.NET Agent\netframework\NewRelic.Profiler.dll
   VSP_AdditionalProfiler_Path=C:\Program Files\New Relic\.NET Agent\netframework\NewRelic.Profiler.dll

6. Restart IIS server