This section includes the following topics:
The Precise for J2EE user can define how Precise for J2EE collects data and how the collected data is displayed. The Settings menu on the Precise bar allows you to configure the following:
The Monitor Settings dialog box enables you to configure and modify the data aggregation and collection definitions for each Precise for J2EE Collector, monitored Java Virtual Machine (JVM) and cluster.
To view and modify the Precise for J2EE monitor settings
You can use the Monitoring Configuration dialog box to view and modify the status of all classes and methods in the selected JVM or cluster. To open this dialog box, go to Settings>Monitor Settings>Monitoring Configuration.
The JVM Loaded Classes table in the Monitoring Configuration dialog box displays all classes and methods detected in the selected JVM in alphabetical order. To ensure that you are viewing the most updated list, check the “Last Updated” date and time on the top right of the window, and if needed, click the refresh icon. If the “JVM is stopped - last saved snapshot” text appears, the JVM must be restarted in order to refresh the list.
The following table describes the information displayed in the “JVM Loaded Classes” table:
Table 1 Monitoring Configuration icons
Column | Description |
---|---|
Class | Displays the loaded classes in the JVM. |
Method | Displays the methods included in the class. |
Status | Displays the monitored status of the selected entity. For more information, see “About Status values” on page 43. |
Type | Displays the type name of the selected entity. For more information, see “About Type values” on page 43. |
Remarks | Displays relevant remarks regarding the selected entity. JDBC methods will not appear in the loaded methods list. Methods invoking JDBC calls will appear with an indicator in the Notes column as “Calls JDBC methods”. |
When there are no pending changes, the list in the table displays “actual” monitoring status of classes and methods in the JVM. If pending changes exist, the list in the table displays “estimated” status of classes and methods in the JVM. |
In the Monitoring Configuration dialog box, you can define and filter the information displayed by selecting one of the pre-defined view options and by using the search fields.
The pre-defined view options are:
In addition to selecting a view option, the user can apply search criteria by either Package/Class pattern and/or Method pattern.
Click the Search (spyglass) icon to search and select an existing pattern name, or begin typing a pattern name into the appropriate field. Precise for J2EE has a unique auto-complete feature which displays a list of all pattern names with letters that match the typed letters in the field. The table displays results based on the selected viewing option and the search criteria.
Click the Clear (X) icon to clear any entered search criteria, or simply delete the pattern name field content.
Status can have any of the values shown below in the table.
Table 2 Available Status values
Name | Description |
---|---|
Monitored | For a class, it means that all of its loaded methods are instrumented. For a method, it means that the method is instrumented. |
Monitored (partial) | For a class, it means that only some of its loaded methods are instrumented. For a method, it means that only some of the signatures are instrumented. |
Excluded | For a class, it means that all of its loaded methods are ignored. For a method, it means that it is ignored. |
Excluded (partial) | For a class, it means that all of its loaded methods are either ignored (exists at least once) or not instrumented (exists at least once). |
<Blank> | For a class, it means that all of its loaded methods are not instrumented (but not ignored). For a method, it means that it is not instrumented (not ignored). |
Pending | Relevant for classes or methods after a change was performed and the JVM was not restarted. The Class will have a pending status if it has at least one pending method. |
The type is used to categorize classes and methods as meaningful parts of the monitored application. Predefined types can contain HTTP, EJB and others. User defined types can be added when defining classes/methods to be monitored. (If no type is defined, the Custom default type is used.) The types are the foundation for displaying response time breakdown into its components in the Precise for J2EE User Interface (for example, how much time is spent in EJBs or in JDBC methods).
The type of methods is either defined by the user, or by the product’s predefined definitions.
The type of classes can be defined by the user or by the product’s predefined definitions, or (when no specific definition exists) as a combination of all of its methods’ types.
The Monitoring Configuration dialog box enables the user to easily view and edit the monitoring status of the loaded classes or methods. It covers a broad spectrum of use cases, serving both novice and experienced users.
A Pending Changes message will appear at the top of the screen after the user has made any changes to instrumentation definitions, and restart has not yet been performed. |
To monitor one or more loaded classes or methods
The user can stop monitoring a selected row in the table according to class or method status. To stop monitoring a loaded class (classes) or methods
Click Save to save your changes, or Cancel to close the screen without saving changes.
Restart JVM after saving your changes. |
The user can exclude a selected row in the table according to class or method status. To exclude (ignore) a loaded class (classes) or methods
Click Save to save your changes, or Cancel to close the screen without saving changes.
Restart JVM after saving your changes. |
Use the Patterns Manager dialog to manage monitoring patterns to view or edit types and matching classes.
User-defined classes can be edited (to add, edit, or delete) types, classes, and methods. |
At the top of the screen, the selected JVM name and its “Last JVM start time” (date and time) are displayed. The Monitoring Patterns table displays configured patterns (classes and methods, and their assigned types). Click Add Pattern (above the table) to create a new pattern name to the table.
Click on the + icon in the table to open and view all members of the selected class.
To add a class or method pattern
The table (lower pane) displays the results (actual instrumentation status) for the selected classes or methods that match the selected definition row (upper pane).
The JVM “Loaded Classes and Methods” displays (in parenthesis) the total number of classes that were loaded. Also displayed is the date and time when the classes were “Last updated”.
Click the Refresh icon to refresh the screen and update all viewed data.
Click on the + icon in the table to open and view all members of a selected class. The table displays the following results:
The Statistics Settings dialog enables you to modify the Application Server Metrics data collection options for the selected JVM or cluster. You can view data for all the selected metrics in the Association area of the Memory and Statistics workspace.
Application server overhead will increase when the application server collects metrics and when the Precise for J2EE collector gathers them. Refer to the application server documentation for further details. |
To configure Statistics Settings
The table below describes the information displayed in the metrics lists.
Table 3 Metrics list fields
Option | Description |
---|---|
Group | Category of statistics in which the metric will be displayed in the Memory and Statistics workspace. |
Metric | Name of metric as it will be displayed in the Memory and Statistics workspace. |
The Populate Configuration dialog box enables you to choose clusters or JVMs and copy the configuration from the selected JVM or cluster in the Monitor Settings dialog box to these clusters or JVMs.
To copy configuration to one or more JVMs or clusters
Using the left and right arrows, move JVMs and clusters between the two lists until all JVMs and clusters that you wish to take on the instrumentation appear in the Selected JVMs/Clusters list.
To search for a specific JVM or cluster, enter the JVM or cluster name (or part of it) in the field above the Available JVMs/Clusters list and click Filter. |
Mark the appropriate option(s) to monitor for leaks and exceptions.
The Dynamic Types Allocation dialog box enables you to customise the appearance of user-defined dynamic types in Precise for J2EE.
In this dialog, you can designate a color to a dynamic type which will represent the specified type in the various breakdown bars throughout Precise for J2EE. You can also define that information regarding specific types will appear in the information ToolTip in these graphs.
Up to 5 dynamic types can be assigned a color or ToolTip, and up to 5 dynamic types can be assigned only a ToolTip.
To define dynamic types, see About the Patterns Manager. |
To configure the dynamic types allocation
The Tree View settings dialog box enables you to modify how information is displayed in the Tree view.
When you click OK in this dialog, the current workspace is automatically refreshed. |
To configure the tree view settings
From the drop-down list, select the maximum number of search results to be returned by a search within the execution tree. The default value is five.
Changing this setting will automatically update the Search dialog box. |
Mark the “Show short name only” check box to display the method name in the execution tree by a short name.
The full method name will always be displayed in the information ToolTip that appears when hovering over any entity in the execution tree. |
The Display Settings dialog box enables you to define Precise for J2EE to retain the selected view or tab, if applicable, when you drill down on an entity or select a different entity. This is sometimes referred to as sticky tabs. For example, if you have chosen the Locks view in the Activity workspace, this will become the default view for all entities, where applicable
To define Precise for J2EE to retain the selected view or
The Time Frame Settings dialog box enables you to modify the default settings for both the time frame for displayed data and the auto-refresh mechanism.
To modify the default settings for the time frame and auto-refresh mechanism