Enable Thread Correlation for .NET

The AppDynamics .NET Agent supports multi-threaded correlation for the following patterns:

• Thread.Start on the Common Language Runtime (CLR) 2.x and CLR 4.x
• ThreadPool.QueueUserWorkItem on the Common Language Runtime (CLR) 2.x and CLR 4.x

Configure Thread Correlation for .NET

Configure all instrumentation settings for the .NET Agent in the config.xml file. See Administer the .NET Agent.

1. Open the config.xml file for editing as an administrator. See "Where to Configure Agent Properties" on Administer the .NET Agent.

2. Copy the code block below to a child element of the Machine Agent element. (See Machine Agent Element):

       <instrumentation>
           <instrumentor name="ThreadCorrelationThreadPoolCLR2Instrumentor" enabled="true"/>
           <instrumentor name="ThreadStartCLR2Instrumentor" enabled="true"/>
           <instrumentor name="ThreadStartCLR4Instrumentor" enabled="true"/>
       </instrumentation>
   

   For example:

   <?xml version="1.0" encoding="utf-8"?>
   <appdynamics-agent xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   ...
    <machine-agent>
       <!--Enable thread correlation-->
       <instrumentation>
           <instrumentor name="ThreadCorrelationThreadPoolCLR2Instrumentor" enabled="true"/>
           <instrumentor name="ThreadStartCLR2Instrumentor" enabled="true"/>
           <instrumentor name="ThreadStartCLR4Instrumentor" enabled="true"/>
       </instrumentation>
     </machine-agent>
   ...
   </appdynamics-agent>
   

   The configuration syntax is enabled="true".
    The agent enables the instrumentor for ThreadPool.QueueUserWorkItem on the CLR 4 by default without changes to the XML.

3. Save the config.xml file.
4. Enable the thread-correlation node property.
5. Restart the AppDyanmics.Agent.Coordinator Service.
6. Restart instrumented applications for your changes to take effect.