HP

HPjmeter 4.1 User's Guide

English
  HPjmeter 4.1 User's Guide > Chapter 7 Using the Console   

Setting Monitoring Session Preferences

The Session Preferences dialog box allows you to:

  • Specify which monitoring metrics to collect.

  • Enable or disable specific alerts.

  • Control filters you can use to specify the information to collect.

Specifying Metrics to Collect for Monitoring

You can open the Session Preferences window at any time by double-clicking on an Open Session, or single-clicking on it then clicking the Session Preferences toolbar button. Launch session
preferences window

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

Metric Preferences Window

In the Session Preferences dialog box:

  1. Click the Metrics tab.

  2. Click the Enabled box to toggle the corresponding metric on or off.

  3. Make sure the measurements that you want are enabled.

  4. To modify filters or alerts, click the corresponding tab.

  5. 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.

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.

  • To enable an alert:

    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:

    Uncheck the box to the right of each alert that you want to disable for the length of the session.

    Update of Session Preferences allowed with HPjmeter 4.0 and later:

    Open the Alert Controller and select Preferences to open the Session Preferences window. See also Changing Session Preferences During a 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

Enable or Disable Alerts Window

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:

  1. In the Session Preferences dialog box, click on the Filters tab.

  2. Double-click the filter name in the list of filters on the Filters tab.

    The Filter Set Editor opens.

  3. 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:

  1. In the Session Preferences dialog box, click on the Filters tab.

  2. Click Add Filter Set.

    The Filter Set Editor opens.

  3. Type the name of the filter set in the Filter Name field.

  4. 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