Skip to end of metadata
Go to start of metadata

On this page:

Related pages:

Your Rating:
Results:
1 Star2 Star3 Star4 Star5 Star
21 rates

By default, you must restart your monitored application 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 do not need to restart your application 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 the web.config file of your application as follows:

<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.