This section includes the following topics:
The Precise for J2EE user interface is comprised of three workspaces - Dashboard, Activity, and Memory & Statistics. Each workspace has a unique focus, highlighting a specific aspect of the performance of your J2EE applications. You can easily navigate between these workspaces to examine the information necessary to successfully track your system’s performance.
The table below describes the three workspaces displayed in Precise for J2EE.
Table 1 Precise for J2EE workspaces
Workspace | Description |
---|---|
Dashboard | Lets you quickly visualize the overall health and status of all instrumented application server instances. The Dashboard workspace provides support for detailed views of individual application servers, as well as top-level summary views of multiple application servers. See “About the Dashboard workspace” on page 19. |
Activity | Lets you investigate your JVM execution tree in a deep or shallow manner, and to track SQL execution, locks and exceptions in the same manner. See “About the Activity workspace” on page 22. |
Memory & Statistics | Lets you examine Application Server metrics. See “About the Statistics workspace” on page 39. |
You can easily switch between the different workspaces using the Workspace Selection bar. See “Switching to a different workspace” on page 14.
Though each workspace is structured differently, most workspaces consist of a Precise bar, workspace selection bar, workspace bar, and two areas - the Main area and the Association area. The Main area (left or top pane) features either a table or a tree view of all monitored J2EE instances, and the Association area (right or bottom pane) includes various workspace specific tabs that display information in various formats, such as tables, graphs, or charts.
The information displayed in one area of the workspace has a direct relation to the information displayed in the other area. When you perform an action on any element in one pane, the information displayed in the other pane changes to reflect this action and to show information for the current selected context.
The figure below shows the common workspace elements.
Figure 1 Sample Dashboard Workspace Structure
The Precise bar enables you to keep track of where you have been and provides various controls. The following table describes the function of each of the toolbar buttons.
Table 2 Precise bar functions
Icon | Name | Description |
---|---|---|
Back | During a work session, keeps track of where you have navigated to. The Back button enables you to navigate between previously visited views. The Back control displays your previous view. | |
Forward | Enables you to navigate to the next view. This button is only enabled if you clicked Back or if you chose a history option. | |
AdminPoint | Opens Precise AdminPoint. | |
Home | Navigates to the highest level entity, usually the instance or AppTier (all instances). The time frame settings remain the same. | |
Stop | Stops a request for information from the server. | |
Refresh | Updates the data currently displayed. | |
Favorites | Enables you to add or remove favorites in your Favorites list. | |
Opens the Print Option dialog where you can select the area of the screen to print. | ||
Opens the default email program with a link in context to the displayed environment. | ||
Settings | Opens one of the following setting configuration:
| |
Help | Opens the online help in context. |
In most workspaces, the left or top area is the Main area. This area displays an overview of all instances monitored by your Precise product. This information can be displayed in either graph, table, or tree format. The time frame that the information is displayed for can be seen in the workspace toolbar, alongside the selected instance name (and drop-down menu) and auto-refresh status. The times displayed are the local times on the FocalPoint server where the page was generated.
The Association area displays in-depth information for the entity selected in the Main area. Each workspace has analysis tabs specific for that workspace. As you navigate through Precise for J2EE, the analysis tabs change to enable you to view specific information relevant to the selected workspace and entity.
For example, the following analysis tabs are available in the Dashboard workspace:
For selected workspaces in Precise products, the association area includes the Findings area, displaying problematic findings for the application. The findings feature is a high level tool, designed to provide the user with an overview of performance issues within the monitored application and enable quick and efficient navigation to the relevant tab for further analysis and handling. The displayed performance findings may indicate performance deteriorations as well as incorrect methods usage. Each finding appears as a row in the displayed table of findings. Hover the mouse indicator over the single-line displayed finding to expand the finding. When expanded, the finding details area provides important guidelines as to what may be the root cause for the reported problem, and what the recommended steps are to resolve this problem.
The table below describes the information that is displayed in the Findings area.
Table 3 Information displayed in the Findings area
Column | Description | |
---|---|---|
Severity | The severity of the finding is calculated using a formula. The position of the finding in the list is determined by an internal scoring system that is based on the knowledge of Precise product experts. The severity is indicated by the following colors:
By default, findings are displayed according to severity. | |
Finding | A short name of the Finding. | |
Context | Entity/Method name (unless specified for the whole instance). The entity/method name is a short name but the long name is displayed in the ToolTip. Some of the findings are identified in specific Methods while others are relevant for the entire instance. In the latter case, a finding is specified as an instance-related finding.
| |
Finding overview | Displays specific details regarding the finding in context.
| |
Learn more (advice) | Provides recommendations for solving the selected finding. For each finding, it lists all relevant pieces of advice and all applicable solutions. You should carefully review all data for the finding and then choose the advice that best suits your needs.
| |
Proceed with the following (bullets) | Provides expert knowledge about the selected finding. The information displayed will direct you if you have difficulties deciding which advice to take or which solution to implement.
|
Perform the following steps to investigate a finding.
To investigate a finding
For more information, see “Examining findings” on page 49.
The term ‘in-context’ means that you can display additional information on a selected item by drilling down to another workspace or view. The filter settings you defined (for example, the selected time frame you chose) and the entity you selected are carried over to the other view or workspace, to allow you to continue analyzing your subject from a different perspective. This concept takes on slightly different meanings depending upon where you are attempting to drill down in context from. In short, the information displayed when drilling down in context is always related to your original selection’s settings.
For example, when viewing information on an instance in the Dashboard workspace, you can click a link in the Details area (right pane) to view additional information on the related workspace, in context of your original selection.
Or when viewing a list of alerts for your product in Alerts, you can open your product in context and continue investigating the factors that led the system to issue that alert.
In short, the information displayed when drilling down in context is always related to your original selection’s settings.
The workspace heading displays the name of the currently selected entity on this screen. When you drill down to a new entity in the Association area, the Workspace heading changes to reflect the name of the newly selected entity.
Precise for J2EE workspaces display information in the following formats:
The user interface displays data per time slice in bar graphs. Bar graphs summarize one slice of data and generally compare several values of similar type, such as time or throughput. For example, contributors of a higher level metric are displayed as bars in the graph, with their type and percentage work time displayed by putting the mouse over the area of interest (see the “Workspace terminology” figure). Each displayed metric value is an average of observations within the slice.
The user interface displays overtime data for a defined time frame in line graphs. Line graphs summarize many slices of data. You can change the number of items plotted by selecting or unselecting check boxes located to the right of the graph. Each point in the graph represents the total metric value for a time slice included in the time series.
The various Precise for J2EE workspaces display information in tables. The way this information is viewed can be modified according to the user's needs, by clicking on the icon to the right of the column header. The following table describes the displays views available.
Table 4 Column display modes in tables
Display Mode (Icon) | Description |
---|---|
Normalized Graph () | This mode displays the breakdown bar in full size for each entity. In this mode you can clearly see the relative breakdown per type for each entity in the table. |
Stacked Bar Graph () | This mode displays a normalized view of the breakdown bar for each entity in relative size to the entity with the highest value. In this mode, you can see the actual breakdown per type (in seconds) for each entity. |
Numerical () | This mode displays the numerical value in the relevant unit size. |
Bar Graph () | This mode displays a solid bar graph for each entity in relative size to the entity with the highest value. |
The following tasks are commonly performed in most workspaces:
You can easily switch between the different workspaces using the Workspace Selection bar. When you start your Precise product, usually the Dashboard workspace opens by default. To select a workspace, click a button on the Workspace Selection bar to display information on the selected entity in a different workspace.
You can configure Precise for J2EE to display transaction performance data for a specific time frame using the predefined time frame options or calendar icons.
Selecting a predefined time frame from the toolbar displays transaction performance data for the selected time period up to the current time. See “Selecting a predefined time frame from the Precise for J2EE toolbar” on page 14.
Selecting the time frame using the calendar icon, you can choose to define a time range independent of the current time, or to define a time range up to the current time. See “Selecting a time frame using the calendar icon” on page 15. The predefined time frame options are:
The time frame selected affects all information displayed in Precise for J2EE. Only data that falls within the selected time frame is shown in these areas.
To select a predefined time frame, from the Precise for J2EE toolbar, select one of the predefined time frames.
To select a time frame
You can select a specific instance to examine in more detail. To select an instance, in the Instance field (located to the right of the Time frame), select the instance you want to examine from the drop-down list.
You can configure Precise for J2EE to automatically refresh collected data displayed on a workspace. By default the option is Auto Refresh is off. To Auto Refresh data, click Auto Refresh is off/Auto Refresh is on.
You can associate the displayed entity with specific data to focus your analysis.
The criteria no longer apply when you drill down to another entity. |
To associate entities with data that meets specific criteria
Some entities display an overtime graph. The overtime graph displays activity statistics over a specified time period. Depending on the number of points displayed in the graph, you may need to zoom in or out. The text displayed on the x-axis varies according to the time frame. If there is a year or day change, x-axis labels will display accordingly.
Use the vertical or horizontal scroll bars (if displayed) to view additional information on the graph. Click the double-arrow (>>) icon to either hide or show the overtime graph legend.
Use the small zoom (spyglass) icon, displayed on the upper right of a time range and above the overtime graph legend, to select a desired time frame that you wish to focus. To select an area on the graph, first click and drag the mouse pointer and then click the spyglass icon.
Tables are used to display information about a set of related entities in either the left or right panes. It is possible to determine which columns to display in the Association area tables.
To determine which columns to display in a table
You can send an email message to one or more recipients from the Precise toolbar. The default subject for the message will be “Link to a Precise environment”. The email will include a link to the Precise product in the current context (time frame and selected entries).
To send an email message
The Favorites function enables you to save a specific location in your environment and to retrieve the same location later without having to navigate to it. For this purpose, a friendly user interface similar to the familiar Favorites option in the Internet Explorer has been implemented.
The new Favorites function includes the following features:
An Add/Delete Favorites option under the Favorites menu allows you to save the current location or delete an existing one.
To add a new Favorite location
To view a Favorites location
To delete an existing Favorite location
The favorite address is displayed in the Address field and cannot be edited. |
The Export to Precise Custom Portal Portlet feature enables you to export the view of the chosen table or graph and generate a portlet with that view in Precise Custom Portal, so that it will provide you with another way of monitoring your environment.
To be able to use this feature, you need to have the following rights in Precise:
If you do not have sufficient rights, you will get an error message when trying to execute this feature.
You can either export a table view or a graph view.
The name field has the following restrictions: maximum 100 characters. |
To export a table view
To export a graph view
The Settings menu on the Precise bar allows you to configure the following:
To configure any of the above-named settings
The Precise user interface is a server-side Java application that listens on a network port for HTML page requests. The syntax of the Precise URL address is:
http://<server machine>:<port>/
where <server machine> refers to the Precise FocalPoint server and <port> refers to the port number that the FocalPoint communicates on. By default, the port number is 20790.
The Precise FocalPoint and Precise for J2EE FocalPoint must be started before they can be accessed. See the Precise Administration Guide to learn how to start Precise and Precise for components. |
To access the Precise for J2EE user interface using Precise StartPoint
admin
. For more information on role names, see the Precise Administration Guide.