In the CA APM Java 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 Java agent for Java applications.

For example, to edit a j2ee.pbd file for an Apache-Tomcat server on Windows: C:\Program Files\apache-tomcat-5.5.12\wily\j2ee.pbd, it is necessary to:

• Replace the keywords HttpServletTracer with SynthHttpServletTracer.
• Find the line beginning with:

  TraceOneMethodWithParametersIfFlagged: HttpServletTypeSpecificServiceTracing 

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

    SetTracerClassMapping: SynthHttpServletTracer com.wily.introscope.agent.trace.SynthHttpServletTracer com.wily.introscope.probebuilder.validate.ResourceNameValidator

  • Second line:

    SetTracerParameter: SynthHttpServletTracer useblame true

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

For example, to edit an IntroscopeAgent.profile file for an Apache-Tomcat server on Windows: C:\Program Files\apache-tomcat-5.5.12\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=HttpServletRequest.getHeader introscope.agent.transactiontracer.userid.key=SyntheticID

• 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. The last property value can be left 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_java_sample.profile sample file located in the <neoload_install_dir>/conf/ca apm/ directory.

• To install the Synthetic User Field Pack extension in the Java agents

1. Install a CA APM (Introscope) Java agent (version 7.x or above) on the server hosting the application to be monitored.
2. Copy the <neoload_install_dir>/conf/ca apm/SynthHttpServletTracer.jar file into the CA APM Java agent ext directory.
3. Edit the j2ee.pbd file in the CA APM Java agent installation directory.
4. Edit the IntroscopeAgent.profile file in the CA APM Java agent installation directory.
5. Restart the application server to load the modified files.