HPjmeter 4.3 User's Guide

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 117).
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:
com.hp.jmeter.jvmagent.
com.hp.jmeter.share.jmx.
com.hp.jmeter.asm.
com.ibm.misc.
com.ibm.jvm.
com.informix.jdbc.IfxDriver
$Proxy
• The default filters also exclude the following packages. However, you can use the include
option to override the default behavior:
com.sun. java. javax. sun.
sunw.io. sunw.util.
COM.rsa.com.jrockit. COM.jrockit.
jrockit.
org.omg.org.ietf.org.apache.
com.hp.ov.org.xml.org.w3c.
weblogic. com.bea. com.beasys.p0. p1.i2.
org.hsql.org.enhydra.com.ibm. com.tivoli.
org.jboss org.jbossmq.
com.netscape.server.http.com.iplanet.EDU.oswego.
oracle.com.orionserver.com.evermind.
28 Completing Installation of HPjmeter