PDFs


This page applies to an earlier version of the AppDynamics App IQ Platform.
See the latest version of the documentation.


Skip to end of metadata
Go to start of metadata

On this page:

Related pages:

By default, you must restart your monitored application and the AppDynamics.Agent.Coordinator service after you create or update:

  • POCO transaction detection entry points
  • POCO service endpoints
  • custom exit points
  • method invocation and http data collectors
  • information points

When you enable runtime reinstrumentation, the .NET agent detects the above types of instrumentation changes and automatically requests the CLR to recompile the affected code. With runtime reinstrumentation enabled you don't need to restart your application or the AppDynamics.Agent.Coordinator service for the instrumentation changes to take effect.

Requirements

Runtime reinstrumentation works for .NET Framework 4.5.2 and greater. You can verify the framework version in your application's web.config:

<system.web>
    <compilation targetFramework="4.5.2" />
    <httpRuntime targetFramework="4.5.2" />
</system.web>

Configure Runtime Reinstrumentation 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 App Agents element. See Default Profiler Element:

    <profiler>
       <runtime-reinstrumentation enabled="true" interval="60000" />
    </profiler>
    

    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">
    ...
    <app-agents>
        <profiler>
          <!-- Enable runtime reinstrumentation -->
          <runtime-reinstrumentation enabled="true" interval="60000"/>
        </profiler>
    ...
    </app-agents>
    </appdynamics-agent>
     
  3. If appropriate configure the runtime reinstrumentation options:
    • enabled: Set to "true" to enable runtime reinstrumentation. Default: "false".

    • interval: The frequency the agent checks for configuration updates in milliseconds. Default: 60000. 

      Because runtime reinstrumentation adds a small amount of system overhead, AppDynamics recommends a minimum interval of 1 minute or 60000 milliseconds.

      The .NET Agent checks for configuration updates every minute, so it may take up to 2 minutes for reinstrumentation to take effect with the default setting of 60000 milliseconds.

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