include=filter1[:filter2]..., exclude=filter1[:filter2]...

Creates a colon-separated list of classes to specify which classes or packages are instrumented. Method-level filtering is not supported.

•If a class is not instrumented, the JVM agent metrics that use bytecode instrumentation (BCI) do not provide any output related to the class methods. To see the list of filters in effect while the data was collected, including default agent filters, click the icon when you see it in the console.

•Class filtering minimizes the overhead and focuses attention on user-produced code.

•By default, the JVM agent instruments bytecode of all loaded classes to implement some of the metrics, except those classes that belong to one of these:

—Application servers, for performance reasons.

—HPjmeter management tools, in order to focus on user-created code.

—A set of implementation-dependent classes that HPjmeter cannot instrument. These cannot be overridden.

•Some metrics display results for all classes regardless of filters, because class filters apply only to those metrics that use bytecode instrumentation.

NOTE: JVM agent filters are distinct from console monitoring filters. For more information, see Setting Monitoring Session Preferences (page 100).

JVM agent filters are configured when you start the JVM, and cannot be dynamically changed.

Console filters are configured when you open a session with a JVM agent, and can be changed from session to session. With HPjmeter 4.0 and later, these filters can also be changed during a session.

If the JVM agent has filtered out a class, the console will be unable to see metrics from that class even if you try to remove the console filter for the class.

•HPjmeter always excludes these packages:

$Proxy

com.ibm.misc.

com.hp.jmeter.jvmagent.

 

com.ibm.jvm.

com.hp.jmeter.share.jmx.

 

 

com.hp.jmeter.asm.

•The default filters also exclude the following packages. However, you can use the include option to override the default behavior:

com.jrockit. COM.jrockit.

COM.rsa.

com.sun. java. javax. sun.

jrockit.

 

sunw.io. sunw.util.

 

 

 

org.apache.

org.ietf.

org.omg.

 

 

 

org.w3c.

org.xml.

com.hp.ov.

 

 

 

i2.

p0. p1.

weblogic. com.bea. com.beasys.

 

 

 

com.ibm. com.tivoli.

org.enhydra.

org.hsql.

org.jboss org.jbossmq.

 

 

 

 

 

EDU.oswego.

com.iplanet.

com.netscape.server.http.

 

 

 

com.evermind.

com.orionserver.

oracle.

 

 

 

18 Completing Installation of HPjmeter