By default, the Splunk AppDynamics .NET Agent enables multi-threaded correlation for these patterns on the Common Language Runtime (CLR) >= 4.x:

  • Task.Start
  • Task.Run
  • TaskFactory.StartNew

The .NET Agent also supports thread correlation for the following patterns which are disabled by default:

  • Thread.Start on the CLR 2.x and CLR 4.x
  • ThreadPool.QueueUserWorkItem on the 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 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="ThreadCorrelationThreadPoolCLR4Instrumentor" enabled="true"/>
            <instrumentor name="ThreadStartCLR2Instrumentor" enabled="true"/>
            <instrumentor name="ThreadStartCLR4Instrumentor" enabled="true"/>
        </instrumentation>
    
    CODE

    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="ThreadCorrelationThreadPoolCLR4Instrumentor" enabled="true"/>
            <instrumentor name="ThreadStartCLR2Instrumentor" enabled="true"/>
            <instrumentor name="ThreadStartCLR4Instrumentor" enabled="true"/>
        </instrumentation>
      </machine-agent>
    ...
    </appdynamics-agent>
    
    CODE

    The configuration syntax is enabled="true".

  3. Save the config.xml file.
  4. Restart the AppDynamics.Agent.Coordinator service.
  5. Restart instrumented applications for your changes to take effect.