Jump to content United States-English
HP.com Home Products and Services Support and Drivers Solutions How to Buy
» Contact HP
More options
HP.com home
HPjmeter: User's Guide > Chapter 8 Using Visualizer Functions

Using Visualizer Tool bars

» 

Technical documentation

Complete book in PDF
» Feedback
Content starts here

 » Table of Contents

 » Glossary

 » Index

All visualizers offer buttons and other controls that help you manipulate the information displayed. See the following sections for details.

Common Tool Bar Buttons

A few buttons appear on most visualizers. They are the following:

Bring console to front Bring Console to Front

Bring console to the front of all other HPjmeter visualizers and viewers.

Print Print

Print the data presented in the visualizer pane.

Save to file Save to File

Save data from a metric display into a file for later viewing. For example, a graphic display of a metric will be saved as a Portable Network Graphics (PNG) file for viewing in software that can interpret this file type.

Compare data Compare Data

Compare data from one or more comparable data sets. For details, see Comparing Data Files.

Tool Bar Buttons for Manipulating Tabular Data

These buttons appear depending on the metric in the visualizer.

Find Find

Brings up a dialog for keyword entry to start a search through the data. See Find a Search Pattern for details.

Find immediately Find Immediately

Immediately start searching on current keyword. See Find a Search Pattern for details.

Mark item for search Mark

Mark an item for search across visualizers. See Mark an Item for Search for details.

Find previous selected item Find Previous Selected Item

Cycle back to a previously selected item. See Find a Search Pattern for details.

Find next selected item Find Next Selected Item

Cycle forward to a previously selected item. See Find a Search Pattern for details.

Calculate live objects nowCalculate Live Objects Now

Collect data and immediately calculate and display live objects in the heap at that moment.

Copy to bufferCopy to Buffer

Copy a portion of or all of the current data display into a buffer. Use this temporarily stored data to populate a spreadsheet or other similar document.

Tool Bar Buttons for Manipulating Graphical Data

These buttons appear depending on the metric in the visualizer.

Unfreeze display Unfreeze Display

Allow the display to continue to scroll as data is updated. SeePause or Resume Graphical Time-based Scrolling for details.

Freeze displayFreeze Display

Stop the data display from scrolling. See Pause or Resume Graphical Time-based Scrolling for details.

Tool Bar Buttons for Manipulating Garbage Collection Data

These buttons appear depending on the metric in the visualizer.

Toggle clock to hours Show Hours:Minutes

Show data along the X-axis according to the hour and minutes at which each event occurred.

Toggle clock to seconds Show Cumulative Seconds

Show data along the X-axis according to the cumulative number of seconds that have passed since the recording started.

Toggle connecting lines on Connecting Lines On

Show GC events with black lines connecting each representative dot in order of occurrence.

Toggle connecting lines off Connecting Lines Off

Show GC events as unconnected dots .

Toggle color distinctions for GC types on Color Distinctions for GC Types On

Show colors that indicate the types of garbage collection used during the application run.

Toggle color distinctions for GC types off Color Distinctions for GC Types Off

Turn off colors that indicate the types of garbage collection used during the application run.

View entire graph Zoom Out

Zoom out from selected interval to show entire graphed area for current metric.

Apply selected interval to all metrics Apply Selected Interval to All Metrics

Apply interval selected in current metric to all other metrics in viewer. Note that the graph automatically zooms in on the Y-axis to provide a more fine-grained view of the data points while in this mode. See also Changing Time Interval in GC Data Visualizers.

Reset default interval for all metrics Reset Default Interval for All Metrics

For all metrics in the viewer, reset the current interval to the default setting.

Button Function Details

This section gives you more detailed information about the functions of some visualizer buttons to help you make better use of these features. See the following sections for details.

Mark an Item for Search

To enable you to work efficiently with multiple windows, the visualizers provide a simple means of marking selected items such as methods, types, objects, and classes, and then locating marked items in other windows, or in displays showing other monitoring metrics. The marking mechanism is based on names, so it works across different data files provided they contain items with matching names.

When you select an item in a display to mark (single-click the item with the left mouse button), click the Mark button in the tool bar, or Mark to Find in the Edit menu. Marking an item copies the name and/or other properties of the current item (highlighted by blue-green color) into the search pattern.

Find a Search Pattern

In the Edit menu there are two find options:

Find Immediately, which uses the current values in the search pattern (usually stored by the most recent Mark operation) or Find, which opens a dialog window that allows you to edit the search pattern before the search. You can also activate these commands via buttons from the tool bar.

The elements of the search pattern used for matching the items depend on the actual kind of items being searched (types, methods, objects, for example) and are a subset of the following list:

  • Java package name

  • Java class name

  • Java type name (classes, primitive types, and arrays)

  • Java method name

  • Java object reference (ID)

As a result of the search, all found items get selected. The first found item becomes the current item, and the window is scrolled automatically to make it visible. The remaining selected items, if any, are displayed on a light yellow background.

If there are multiple selected items, you can change the current item using Find Previous Selected and Find Next Selected from the Edit menu or use the appropriate buttons on the tool bar. These actions also automatically scroll the window.

You can also choose multiple selections manually by holding down the SHIFT key while clicking the mouse button to add a new item to the selected set.

Figure 8-24 Finding an Item

Data showing current item in a find operation

Pause or Resume Graphical Time-based Scrolling

You can pause and resume graphical time-based scrolling by clicking the clock icon in the upper left corner just above the visualizer display area.

The following image shows a display that is running. Pressing the clock would pause the scrolling of the data. Pressing the clock again would allow the display to resume scrolling.

Figure 8-25 Using the Pause Clock

Using the Pause Clock

Changing Time Interval in GC Data Visualizers

The GC viewer provides several ways for you to manipulate the breadth of the data in the specialized GC visualizer displays. You can

Select a Subset of the Available Data

To select a subset of data, click one location on the graph and drag the mouse cursor across the graph area from left to right until you have defined an area that you want to explore in more detail. Release the mouse button, and the screen repaints with the new interval filling the entire graphical area.

Using the View menu, you can choose whether to base the selection on the X axis, the Y axis , or both. The X axis is the default setting.

Figure 8-26 The View Menu Selections in the GC Viewer

The View Menu Selections in the GC Viewer

To drill in further, repeat this method of defining the area of view until you reach your desired resolution.

Use the slider underneath the graph to view additional ranges in the data without changing the resolution interval.

The following images show a selected area on a graph and the resulting display.

Figure 8-27 Specialized GC Graph with Area Selected for Finer Resolution

Specialized GC Graph with Area Selected for Finer Resolution

Figure 8-28 New Resolution After Selection

New Resolution After Selection
Apply Selected Interval Across All Metrics

When you have your desired resolution in one metric visualizer, click the Apply Interval button to apply the selected time interval across all metrics in the GC viewer. This resolution will apply until the reset button is clicked or a new resolution is chosen.

Note that although the X-axis (Clock Time) has not changed from the previous figure, the graph automatically zooms in on the Y-axis to provide a more fine-grained view of the data points while in this mode.

Figure 8-29 Resolution After Interval Applied to All Metrics

Resolution After Interval Applied to All Metrics
Reset Interval to Default Settings Across All Metrics

Click the Reset Interval button to reset all metrics to their original graphic display seen on first opening the GC viewer.

Printable version
Privacy statement Using this site means you accept its terms Feedback to webmaster
© 2006 Hewlett-Packard Development Company, L.P.