IBM Tivoli Composite Application Manager for Application Diagnostics, Version

Disable various types of Byte Code Instrumentation for J2EE APIs

In Byte Code Instrumentation (BCI), the data collector intercepts method entry and exit calls for various types of Java APIs in order to create an execution flow of each application request. Some resources are used for the monitoring. You can tune the data collector so that some of the APIs are not monitored, reducing resource use. For some APIs, you can also disable collection of BCI information for MOD L1, reducing resource use for this level (typically enabled most of the time on production systems).

To disable BCI monitoring for J2EE APIs, set (or uncomment) the following properties in the toolkit custom properties file (see The Toolkit properties file). These properties are set to true by default. After changing the file, restart the application server instance.

Adding lines to

Type of J2EE API Line to add to file
Enterprise JavaBeans (EJB)
Java Connector Architecture (JCA)
Java Database Connectivity (JDBC)
Java Naming and Directory Interface (JNDI)
Java Message Service (JMS)
Web containers for Servlets/JavaServer Pages (JSP)
HTTP session count tracking
CICS Transaction Gateway (CTG)
Java Data Objects (JDO)
Message Queue Interface (MQI)
Axis web service
Remote Method Invocation (RMI)
WAS EJB container
WebSphere Portal Server 5.1
WebSphere Portal Server 6

For most API types, BCI information is only collected for MOD levels L2 and L3. If the MOD Level is set to L1, BCI data is not sent to IBM Tivoli Monitoring or the Managing Server, although the method entry and exit is still intercepted. (The MOD Level set for IBM Tivoli Monitoring does not affect the data sent to the Managing Server, and vice versa).

For the following API types, BCI information (if it is not disabled completely, as shown above) is also collected at MOD L1. For performance reasons, you can also disable it only for L1 monitoring, while keeping it enabled for L2 and L3. To do this, add (or uncomment) the following lines in the toolkit custom properties file (see The Toolkit properties file):

Modifying lines in

Type of J2EE API Line to add to file

Setting any of these properties to false may result in some missing data when MOD Level is switched from L1 to L2. For example, the data collector may not be able to determine the Data Source names for JDBC requests.

Parent topic:

Tune data collector performance and monitoring scope