Reference Pattern View

Purpose · Elements

Slices and Workspaces: Introduction

Table view of methods, showing time and number of calls per method

Table view with user-defined slices. Shows time per thread spent in each slice. Shown using bars.

Purpose

Elements

Main View

A Table view may be opened to show information about threads, packages, classes, methods, object, individual method invocations, or user-defined slices. Shown above are a Table view of methods and a Table view of threads.

The rows are the elements of your program run (classes, objects, threads, etc.), and the columns are attributes of those elements the user may choose, which include such things as measurements of execution activity or memory.

Clicking on a column heading sorts the data shown in the column. By default, numeric columns are sorted in descending order. To sort in ascending order user Shift-click.

Each table view lets you select one or more rows by clicking on a row with the left mouse button (or optionally with the Shift or Ctrl key to select more than one row). Selected rows appear against a yellow background, both in the current view and in other views. One reason for selecting rows is to do some additional analysis, either in this view or in other views, based on the selections made. Right-clicking on a row both selects the row and presents a popup menu (see below).

The Table view may also be used to study information along two dimensions at the same time (as shown in the second view above), in conjunction with user-defined slices. In this case there will be a column for each slice, for each measurement displayed. See Using Slices in the Table View for a full discussion of these features.

A Table view where the rows are slices has additional features for managing the slices in a workspace; see Slice Operations for details on this use of the Table view.

Menus

• Popup menus.
Right-clicking on a row presents a popup menu, and also selects that row (if it is not already selected). Drill Down from Selected Items lets you open a view that is restricted to the current selections. Create a New Slice will create one or more new slices from the current selections. You can create either a single slice From Selected Items or one slice For Each Selected Item. Choosing Limit an Existing Slice presents the set of execution slices you can choose to limit to Selected Items.
 
• File menu.
The tabular data in the view can be saved by selecting Export to File, which writes the current table contents to a text file in a comma-separated value format. The default file type is .csv, which is recognized by popular spreadsheet programs. The columns currently displayed will be exported to the file.

Select Close to close the window showing this table view.

• Rows menu. This menu controls the set of items (methods, objects, classes, etc.) to be displayed as rows in the table. Clicking on Display Current Selection (Now) updates the view to show only rows for items currently selected. The other option, Display Current Selection (Live), is a toggle. In this mode, whenever the user makes new selections the view will automatically update to show only the items matching the current selection.

  The option Display All Items will show as rows all the items that were loaded from the trace (including those outside of the workspace base slice filtering). Alternatively, the option Display All Items in Slice presents a set of execution slices you can choose from; only the items in that particular slice will appear as rows.

  The options Expand Rows and Compress Rows alter the height of each row. This is especially useful when viewing detailed data (such as measurements of individual method invocations) as bars. You can vertically compress the rows to see more of them in the view. You may expand or compress rows by using the small arrow buttons in the upper right corner of the view, or the keys "<" or "/" (compress), or ">" or "*" (expand).

  You may also Select All Rows or choose Clear Selection to deselect any selections currently in effect.

• Columns menu.
The Choose Attributes option displays a list of all attributes applicable to the particular table view. Check off the attributes you want to see displayed as columns in the table. The attributes listed for each table view are as follows:


attribute                    class object method thread invocation slice package

class name                      x      x      x
short class name                x      x      x
package name                    x                                         x
short package name                                                        x
instance size                   x
is array                        x

base time                       x      x      x      x      x      x      x
cumulative time                 x      x      x      x      x      x      x
number of calls                 x      x      x      x             x      x
base time (methods)             x                                         x
cumulative time (methods)       x                                         x
number of calls (methods)       x                                         x
number of instances             x                                  x      x
number of live instances        x                                  x      x

id                                     x
is class object                        x
size                                   x
is live                                x
creation time                          x
collection time                        x
lifespan                               x
generation                             x

method name                                   x             x
short method name                             x
is constructor                                x
is class constructor                          x
thread name                                          x      x
thread object class                                  x
thread object id                                     x

method class name                                           x
target object class name                                    x
target object id                                            x
start time                                                  x
end time                                                    x
has callees                                                 x

slice                                                              x
definition                                                         x
parent slice                                                       x
total size of instances                                            x      x
total size of live instances                                       x
size of live instances                                                    x

attribute                    class object method thread invocation slice package

 

Display Bars toggles between displaying numeric data as bar graphs or as numbers.

A number of features are provided to use if you have defined slices. Choose Slices lets you specify the slices for which you want to see attribute columns displayed in the table. Color by Slice colors the rows of the table according to the slice in which they belong. Display Percentage of Base shows slice-dependent measurements as a percentage of the base slice. See Using Slices in the Table View for details of using these features.

• Selected menu. These options are active only when current selection(s) exist. Drill Down from Selected Items lets you open a view that is restricted to the current selections. Create a New Slice will create one or more new slices from the current selections. You can create either a single slice From Selected Items or one slice For Each Selected Item. Choosing Limit an Existing Slice presents the set of execution slices you can choose to limit to Selected Items.

 
• Help menu. Selecting Help in a view attempts to use your browser to display the Reference Manual documentation for that view. The browser program location is specified in the environment variable JINSIGHT_BROWSER, in the shell script named jinsight that invokes the visualizer.

 

See Using Slices in the Table View for a detailed discussion of how the Table view works with slices and workspaces.

Reference Pattern View

Jinsight Home

Slices and Workspaces: Introduction