Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The following procedure describes how you can enable an additional configuration file.

To enable an additional configuration file1.    Open

  1. Open the InstrumenterConfigList.xml file in the JVM ID-specific configuration directory for your application server:

...

  1. <i3_root>/products/i3fp/registry/products/j2ee/config/JVMID/

...

  1. In the InstrumenterConfigList.xml file, locate the XML block that defines the file you want to enable. For example, to enable the JNDI custom instrumentation file, locate the following section:

 

  1. <!--

...


  1.      JNDI
         Uncomment to instrument.

 

 

  1. -->
    <!--
         <config-file>
         JNDI.xml
         </config-file>

 

...

  1. -->
  2. Remove the XML comments surrounding the file name. For example:
    <!--

 

 

-->

  1.      JNDI
         Uncomment to instrument.
    -->
    <config-file>
         JNDI.xml
    </config-file>

Adding your own custom instrumentation configuration file

The following procedure describes how you can add your own custom instrumentation configuration file.

To add your own custom instrumentation configuration file1.    Create

  1. Create a new user-defined XML configuration file, for example:
    UserDefined.xml, in the following way:
    <?xml version="1.0" encoding="UTF-8"?>
    <!--
         User Defined Instrumenter Configuration File
    -->
    <instrumenter-config>
         <custom-config>
              <java-classes>
                   <java-class>
                        <class-

...

  1. name>
                        </class-name>
                        <methods>
                             <method>
                                  <name>
                                  </name>
                             </method>
                        </methods>
                   </java-class>
              </java-classes>
         </custom-config>
    </instrumenter-config>

 

...

  1. To add the file to the InstrumenterConfigList.xml file, use the following syntax:
    <!--

->

  1.      User defined instrumenter config file

...

  1. -->
         <config-file>
              UserDefined.xml
         </config-file>

...

  1. Modify the new XML configuration file to include the interfaces, classes, and methods you want to instrument. See the next section for more information.

About custom instrumenter configuration

...