Setting Monitoring Session Preferences

The Session Preferences dialog box allows you to:

Specify which monitoring metrics to collect.
Control filters you can use to specify the information to collect.
Enable or disable specific alerts for the duration of the session.




	NOTE: Changes you make to Session Preferences affect the information you collect for the entire monitoring session. For example, if you disable certain metrics or alerts, those will not be available. You must start a new session to enable those settings. The benefit of disabling items in the Session Preferences is that it reduces overhead on your application because HPjmeter is collecting less information.

Specifying Metrics to Collect for Monitoring

In pre-deployment or development, it is typical to enable all items. In deployment mode, when you may be concerned about the impact on the application, you can enable a subset of the available items. For more information about performance, see Performance Overhead on Running Applications.

Reduce monitoring overhead by turning off metrics that you don't need for a monitoring session.

Figure 7-4 Metric Preferences Window

In the Session Preferences dialog box:

Click the Metrics tab.
Click the Enabled box to toggle the corresponding metric on or off.
Make sure the measurements that you want are enabled.
To modify filters or alerts, click the corresponding tab.
Click OK to save the changes.




	CAUTION: TheThrown Exceptions with Stacktraces metric is unselected by default. Because collecting stack traces can impair your application's performance, enable this metric only when you need to get information about where most exceptions are thrown. For details, see Thrown Exceptions with Stack Traces.

To reset the selections to the original settings, click Restore Defaults.

Related Topics

Specifying Filters for Monitoring

You can control the amount of information that HPjmeter provides during a live session by filtering out classes using the Filters tab of the Session Preferences dialog box.

Filters may be inclusive or exclusive, but not both:

Inclusive filters include only the specified classes in a filter set.
Exclusive filters remove all classes that are listed in a filter set.

You can add new filters or edit existing filters as desired.

To begin editing an existing filter, double-click the desired filter listed on the Filters tab.
To add a new filter, click Add Filter Set.
To reset the selections to the original settings, click the Restore Defaults button.

HPjmeter uses bytecode instrumentation to collect data. If a class is not instrumented, the JVM agent metrics that use bytecode instrumentation do not provide any output related to the class methods. To see the list of filters in effect while the data was collected, click the BCI
Filter icon where it appears in monitoring displays..

Editing Filters

To edit an existing filter: where it appears in monitoring displays “Using Monitoring Displays”.

In the Session Preferences dialog box, click on the Filters tab.
Double-click the filter name in the list of filters on the Filters tab.
The Filter Set Editor opens.
Specify the list of packages for the filter in the Filter Set field. See Specifying Filters for Monitoring for details.

Adding Filters

To add a new filter:

In the Session Preferences dialog box, click on the Filters tab.
Click Add Filter Set.
The Filter Set Editor opens.
Type the name of the filter set in the Filter Name field.
Specify the list of packages for the filter in the Filter Set field. See Specifying Filters for Monitoring for details.

Specifying Filter Sets

Filter sets are comma-separated lists of packages, classes, or both. You can use wildcards or periods at the end of the name only, but they are not necessary. For example, the following are permitted:

javax.swing.*
com.foo.bar.
mypackage.MyClass

Names such as *.util and com.*.util are not valid.

Related Topic

See include/exclude options in JVM Agent Options

Enabling Monitoring Alerts

If you turn off an alert in the Session Preferences dialog, it will not show in the alert controller window and no data will be generated for it for the length of the opened session.

To enable an alert for the duration of a session:
When opening a session, check the appropriate box in the Alerts tab of the Session Preferences window. If the box is checked when the session is opened, then the alert will be available in the session.
To disable an alert for the duration of a session:
Uncheck the box to the right of each alert that you want to disable for the length of the session.
To enable e-mail notification to the address of your choice when alerts are logged by HPjmeter:
Click Set Notification, and fill in the fields and desired options. At minimum, click the check box to the left of Activate e-mail notification to enable e-mail notification for the duration of this session. For information on using the e-mail notification editor, see “Editing E-mail Notification Attributes”.
To reset the selections to the original settings:
Click the Restore Defaults button.

Figure 7-5 Enable or Disable Alerts Window

Related Topics

Using the Alert Controller to deactivate or reactivate enabled alerts

Setting Monitoring Session Preferences

Technical documentation

» Table of Contents

» Glossary