In the CA APM .NET agent

To use the Neotys Design Studio module for CA APM, it is necessary to install the Synthetic User Field Pack Extension in the CA APM agent.

For example, to edit a the dotnet.pbd file on Windows: C:\Program Files\CA Wily\dotNetAgent\wily\dotnet.pbd, it is necessary to:

• Replace the keywords "PageInfoTracer" with "SynthPageInfoTracer".*
• Find the line beginning with:

  TraceOneMethodWithParametersIfFlagged: ASPNETTracing

• Add the following two lines immediately before it.
  • First line—single line:

    SetTracerClassMapping: SynthPageInfoTracer 

      com.ca.gd.asp.SynthPageInfoTracer 

      com.wily.introscope.probebuilder.validate.ResourceNameValidator

  • Second line:

    SetTracerOrdering: SynthPageInfoTracer -1000

• Warning: It is recommended to copy the correct lines from the dotnet_sample.pbd sample file located in the <neoload_install_dir>/conf/ca apm/ directory.

For example, to edit an IntroscopeAgent.profile file on Windows: C:\Program Files\CA Wily\dotNetAgent\wily\IntroscopeAgent.profile, the following elements are required:

• The two keys under the Transaction Tracer Configuration heading must not start with the # character and must be filled in as follows:

  introscope.agent.transactiontracer.userid.method=HttpRequest.Headers.Get introscope.agent.transactiontracer.userid.key=SyntheticID

• The key under the Enabling Collection of Filtered Parameters heading must not start with the # character and must be filled in as follows:

  introscope.agent.asp.disableHttpProperties=false

• The three keys under the URL Grouping Configuration heading must not start with the # character and must be filled in as follows:

  introscope.agent.urlgroup.keys=default 

  introscope.agent.urlgroup.group.default.pathprefix=* 

  introscope.agent.urlgroup.group.default.format=Default

• Information: Thus configured, all resources in a page are grouped under a single Default node. You may leave the last property value empty to retrieve separate metrics for each request in a page. However, leaving the property value empty can result in significantly more metrics and overhead being generated by the Introscope (CA APM) agent which could adversely affect the performance of the monitored applications.
  See the CA APM documentation for more details on configuring URL grouping.

• Warning: It is recommended to copy the correct lines from the IntroscopeAgent_dotnet_sample.profile sample file located in the <neoload_install_dir>/conf/ca apm/ directory.

• To install the Synthetic User Field Pack extension in the .NET agents

1. Install a CA APM (Introscope) .NET agent (version 7.2.2.0 or above) on the server hosting the application to be monitored.
2. Copy the <neoload_install_dir>/conf/ca apm/SynthPageInfoTracer.ext.dll file into the CA APM .NET agent ext directory.
3. Edit the .NET application properties file. This file is usually named web.config or machine.config.
   • Locate the <runtime> XML tag and insert the following XML node:

     <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1"> 

       <dependentAssembly> 

         <assemblyIdentity name="wily.Agent" publicKeyToken="2B41FDFB6CD662A5"/> 

         <bindingRedirect oldVersion="7.2.2.0" newVersion="9.0.0.0" /> 

       </dependentAssembly> 

     </assemblyBinding>

   • Replace the value of the newVersion attribute for the bindingRedirect tag with the version for the .NET agent monitoring the .NET application.
   • Repeat this step for each .NET application being monitored by a .NET agent.
4. Edit the dotnet.pbd file in the CA APM .NET agent installation directory.
5. Edit the IntroscopeAgent.profile file in the CA APM .NET agent installation directory.
6. Restart the application server to load the modified files.

• Warning: It is recommended to copy the correct lines from the web_sample.config sample file located in the <neoload_install_dir>/conf/ca apm/ directory in order to avoid any character coding problems resulting from a cut and paste from this document.