•On occasion, you can successfully connect to the JVM and open a session, but discover that no metrics are available for viewing (menu options are grayed out). This can occur if the application is experiencing a long GC at the time that you open the session.

Once the GC completes, the console should begin receiving data and behave normally.

•You can set a log level on the console, which allows you to collect varying amounts of information about the console and node agent. To set the log level, use this command to manually start a console:

$ JMETER_HOME/bin/hpjmeter -log level_of_detail

Available log levels:—FINEST (most impact on performance)—FINER—FINE—CONFIG—INFO—WARNING (default setting)—SEVERE (least impact on performance)—OFF (turn off logging)

JVM agent

•If the console runs out of memory during an open session, the JVM agent will close its session a few minutes later. Then the JVM agent prints out this to standard error on its controlling terminal:

HPjmeter JVM agent

warning: Session communication channel failure. Forcing session closure.

When you start a new console, you can reopen a session with the JVM agent.

•You may see an OutOfMemoryError when your application is running with the JVM agent. One possible cause is that after HPjmeter inserts the agent bytecode instrumentation, the loaded class data is larger and it needs more space in the Java heap. In the case of HotSpot, more permanent space is used. If the required permanent space size exceeds HotSpot's default MaxPermSize, which is determined by the HotSpot version, HotSpot will throw the OutOfMemoryError. You can use the HotSpot nonstandard option -XX:MaxPermSize= to set a larger MaxPermSize to avoid the OutOfMemoryError.

•If you see this JVM agent error on startup:

The HPjmeter JVM agent could not

load a class from agent.jar. Please check your classpath and Xbootclasspath.

The HPjmeter agent has encountered an error (log file: HPjmeter.jvmagent_28766.log). Please contact java-tools-support@hp.com for support.

Check for these conditions:

—The -Xbootclasspathoption may be missing from the command line. (This should not be the problem if you are using the -agentlibswitch. -Xbootclasspathis optional when used with -agentlib.)

—If you have an -Xbootclasspathargument, then make sure the path it is pointing to is correct.

•On an HP Integrity (Itanium) server, you see that the JVM agent is not starting and the error message indicates that the HPjmeter shared library cannot be found, as follows:

Error occurred during initialization of VM Could not find -Xrun library: libjmeter.so

194 Troubleshooting