Using Visualizer Tool bars

These buttons appear depending on the metric in the visualizer.

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 [

Marked java.util.BitSet.recalculatedUnitsinUse

Using the Marked Object List on the Console

Each time an object is marked in a visualizer, a history list on the console is updated. The list is limited to the seven most recent marked items.

[D]

Use this list to find marked objects across sessions or data files; anywhere within the data sets that are currently viewable in the console.

To use this feature, do the following:

1. Open the Marked drop-down and view objects marked thus far in HPjmeter visualizers.

2. Click the object that you want to find.

   This makes the selected object in the drop-down become the current marked object.

3. Now open the visualizer where you want to search for the object.

4. Click the Find or Find Immediately button to search for the object.

In the Edit menu (and on the tool button bar), there are two find options:

Find Immediately [

[D]

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:

As a result of the search, all found items are highlighted. The first found item becomes the current selected item (shown with a blue background), and the window is scrolled automatically to make it visible. The remaining selected items, if any, are displayed on a light yellow background. The number of matches displays briefly in the message area in the lower right bottom of the visualizer window.

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. (See “Tool Bar Buttons for Manipulating Tabular Data” for the complete list of Mark and Find buttons and their meaning.)

You can also add additional items to the highlighted set by holding down the SHIFT key while clicking the left mouse button. Each new item added to the selected set is also highlighted in light yellow.

Figure 8-25 Finding an Item

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-26 Using the Pause Clock

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-27 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-28 Specialized GC Graph with Area Selected for Finer Resolution

Figure 8-29 New Resolution After Selection

Apply Selected Interval Across All Metrics

When you have your desired resolution in one metric visualizer, click the 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-30 Resolution After Interval Applied to All Metrics