# Profiler chaining for the .NET Framework agent

You can use profiler chaining to run the .NET Framework agent alongside other .NET profiler agents, such as performance or APM tools. To do this, you must enable the agent.dotnet.enable_chaining configuration setting in the third-party tool, and the Contrast .NET Framework agent must be restarted.

Once restarted, the Contrast .NET Framework agent automatically detects the presence of other profiling tools registered with IIS and configures the environment to load both the Contrast .NET Framework agent profiler and the third-party profiler.

The Contrast .NET Framework agent is tested and proven to be compatible with the following profiling tools:

Profiling tool

Versions tested

AppDynamics

4.5.18.1

Dynatrace

1.193.159.20200602-190835

New Relic

8.23.107

### Note

The agent is likely compatible with other profiling tools if those tools follow the conventions of the CLR Profiling API and do not make assumptions about the profiling environment.

Depending on how you are using profiler chaining, follow these steps to configure:

• If you are using profiler chaining with IIS:

Install the third-party agent, then the Contrast .NET Framework agent.

(If you install the Contrast .NET Framework agent before the third-party agent, you need to restart the Contrast.NET Main Service under Windows Services.)

• If you are using profiler chaining outside of IIS:

### Important

The agent.dotnet.enable_chaining configuration flag will not work if you are using profiler chaining for applications:

• hosted outside of IIS, or

• that use the third-party agent's Nuget package (rather than the installed agent).

If this applies to you, replace the CLR environment variables for the profiling tool with CONTRAST_CCC_CLR versions. Any of these names should be transformed:

Change this

To this

CLR_PROFILER

CONTRAST_CCC_CLR_PROFILER

CLR_PROFILER_PATH

CONTRAST_CCC_CLR_PROFILER_PATH

CLR_PROFILER_PATH_32

CONTRAST_CCC_CLR_PROFILER_PATH_32

CLR_PROFILER_PATH_64

CONTRAST_CCC_CLR_PROFILER_PATH_64