The following sections summarize how to use HPjmeter to
monitor applications. Detailed descriptions of the behavior of HPjmeter are
linked to from each section.
Configure and Start Your Application
Set
the command line of your Java application to use the JVM agent and
any desired agent options.
Choose Connect from the File menu or click Connect to server [ ]
In
the Connect to Server dialog box, type the complete host name (server.domain.com) on which a Java application and
a corresponding node agent are running.
Optionally, in the Optional Port box, specify the same port number that was
used when the node agent was started.
Click Connect.
After a few moments,
the running JVM for each application identified should appear in the
console main window pane marked with one of the following symbols:
— A JVM that has already
loaded an HPjmeter JVM agent
— A JVM that has not yet
loaded an HPjmeter JVM agent
Repeat
the previous steps if you want to connect to several node agents on
several servers at once.
Procedure 3-3 Secured Connection to Server
To connect to a node agent via a SecureShell (SSH)
tunnel:
Choose Connect from the File Menu or click Connect to server [ ]
In
the Connect to Server dialog box, type the complete
host name (server.domain.com) of the system
that is the designated host for the SSH tunnel (the SSH
delegate machine).
Optionally, in the Optional Port box,
specify a port number through which information can pass from the
SSH delegate to the node agent.
Check the box labeled Use SSH Options.
The Connect to Server dialog expands to reveal required SSH
attributes.
Type the IP address External IP) of the SSH delegate.
Type
the port number (External Port) on the SSH delegate
through which information can pass from the SSH delegate machine to
the console.
Type
the port number (Internal Port) listened to on
the console side that can accept information from the SSH delegate
machine.
Click Connect.
After a few moments,
the running JVM for each application identified should appear in the
console main window pane marked with one of the following symbols: or .
Repeat
the previous steps if you want to connect to several node agents.
Set Session Preferences
Double-click on the JVM
icon in the data pane for the application that you want to monitor.
This opens the Session Preferences dialog box.
NOTE:
When the Optional Port Box Is Not Used
The console automatically attempts to use a port on the remote
system between 9505 and 9515 when arranging a port for its server
socket. If it is unable to successfully use a port from this range,
it will use an ephemeral port number.
By clicking the tabs in
this dialog, you can see the default settings for metrics, filters,
and alerts. Enable or disable the settings as desired.
Interdependencies Exist Among Some Metrics and Between Some
Metrics and Alerts:
Some metrics are obtained together and do not display independently
from one another. When this occurs, checking one metric may activate
others, as shown in the following image.
Some alerts require collection of specific metrics
such that even if a metric is de-selected, it may be activated by
selection of a related alert.
Once all selections are
made, click OK. The preferences window will
close and the new Open Session will be visible, marked by this icon:
Though it is possible to begin viewing application
activity immediately in the monitoring visualizers, you may want to
wait for a short period of time before viewing some of the metrics.
The length of time needed to collect sufficient data depends on the
application size, the load imposed on the application, and on the
selected preferences. Typically, a wait of 5 to 30 minutes provides
sufficient data to begin seeing significant clues to the application
behavior and performance. A longer collection time gives you greater
accuracy in the results. For details, see: Setting Monitoring Session Preferences .
Changing Session Preferences During a Session
With HPjmeter 4.0 and later,
it is possible to change session preferences during a session.
Double-click the “Open
Session” line in the console for the session that you want to
change.
The Session Preferences window opens.
Alternately, selecting the
“Open Session” line on the console enables the Session
Preferences icon on the console tool bar. Click the icon to open
the Session Preferences window.
View Monitoring Metrics During Your Open Session
Click on the open session or time slice to highlight
the data that you would like to view.
Use the Monitor menu on the console
main window to select the metrics that you want to see. Mousing over
each category in the cascading menu will reveal the relevant metrics
for that category.
Click a metric to open a metric visualizer displaying
the chosen data.
For details on individual metrics and how to interpret
the data display, see: