Viewing data with Tivoli Performance Viewer
Use this page to view and refresh performance data for the selected server, change user and log settings, view summary reports, and information on specific performance modules.
To view this administrative console page, click
.Click the server name to view the current activity for that server. In this view, the Tivoli® Performance Viewer has two main parts, which include the navigation panel and the data viewing panel.
Refresh
Click Refresh to rebuild the navigation tree. Refreshing is helpful when the available Performance Monitoring (PMI) Infrastructure data has changed, and the tree does not reflect those changes.
View Module(s)
Click View Module after one or more performance modules are selected in the tree to display the information for these modules in the data viewing panel.
- Viewing Counter panel
- Counter Selection panel. If necessary, you can change the scaling factors by editing the default values in the scale field.
Deselect All
Click Deselect All to quickly deselect all modules that are selected in the navigation tree.
Navigation tree
Use the navigation tree to view advisor output, configure Tivoli Performance Viewer, and select PMI modules for viewing.
- Click the Advisor node to have the advisor display the data in the viewing panel.
- Expand the Settings node to select and configure either the User or Log settings.
- Expand the Summary Reports node to view summary reports for an application server.
- Expand the Performance Modules node to view one or more PMI modules.
Advisor
Click Advisor to examine various data while your application is running. The Performance Advisor provides advice to help tune systems for optimal performance using the PMI data collected.
The first table represents the number of requests per second and the response time in milliseconds for the web container.
The pie graph displays the CPU activity as a percentage of busy and idle.
The third table displays average thread activity for the different resources, for example, Default, Object Request Broker, and web container. Activity is expressed as the number of threads or connections busy and idle.
To view detailed information about the advice, select the message you want to view. This view provides additional information about the advice message, severity, description, user action, and detail.
User settings
Change the values as needed for the following user settings:
Information | Value |
---|---|
Refresh Rate | Specifies how frequently Tivoli Performance Viewer collects performance data for a server from the Performance Monitoring Infrastructure (PMI) service provided by that server. The default is 30 seconds. To collect performance data for the server more frequently, set the refresh rate to a smaller number. To collect performance data less frequently, set the refresh rate to a larger number. The allowed range is 5 to 500 seconds. |
Buffer Size | Specifies the amount of data to be stored for a server. Data displayed in Tivoli Performance Viewer is stored in a short in-memory buffer. After the buffer is full, each time a new entry is retrieved the oldest entry is discarded. The default buffer size is 40. Allowed values are 10, 20, 30, 40, 50, 60, 70, 80, 90 and 100. The larger the buffer size, the more memory is consumed. Thus, specify a buffer size that allows you capture enough monitoring data for analysis without wasting memory storing unneeded data. |
View Data As | Specifies how counter values are displayed. Viewing options include the following:
|
Log settings
The log settings control what happens when Start Logging is clicked in, for example, a summary report on the performance of a servlet, enterprise bean (EJB), EJB method, connection pool, or thread pool.
Change the value as needed for the following log settings:
Information | Value |
---|---|
Duration | Specifies the length of time, in minutes, that logging continues, unless Stop Logging is clicked first. Tivoli Performance Viewer is not intended as a full-time logging solution. |
Maximum File Size | Specifies the maximum size, in megabytes, of a single file. Note that Tivoli Performance Viewer automatically zips log files to save space and this parameter controls the pre-zipped file size and not the post-zipped, which is smaller. |
Maximum Number of Historical Files | Specifies the number of files Tivoli Performance Viewer writes before stopping. If Tivoli Performance Viewer reaches the maximum file size before the logging duration ends, it continues logging in another file, up to the maximum. If Tivoli Performance Viewer reaches the maximum number of historical files before the logging duration ends, Tivoli Performance Viewer deletes the oldest historical file and continues logging in a new file. The total amount of data that is stored is constrained by the Maximum File Size and Maximum Number of Historical Files parameters. |
File Name | Specifies the name of the log file. The server name and the time at which the log is started is appended to the log name to help users identify a log file. |
Log Output Format | Specifies whether Tivoli Performance Viewer writes log files as XML or in a binary format. Binary format is recommended as it provides a smaller log file when not compressed. |
Summary Reports
Summary reports are available for each application server.
Before viewing reports, make sure data counters are enabled and monitoring levels are set properly.
The standard monitoring level enables all reports except the report on Enterprise JavaBeans (EJB) methods. To enable an EJB methods report, adjust the PMI level to include EJB method data.
Tivoli Performance Viewer provides the following summary reports for each application server:
- Servlets
- The servlet summary lists all servlets that are running in the current application server. Use
the servlet summary view to quickly find the servlet that consumes the most time and the
applications that use them, and to determine which servlets are invoked most often. You can sort the
summary table by any of the columns.
Tips:
- Sort by Avg Response Time to find the slowest servlet or JavaServer page (JSP). The Avg Response Time is specified in milliseconds.
- Sort by Total Requests to find the servlet or JSP used the most.
- Sort by Total Time to find the servlet or JSP with the highest response times.
- EJBs
- The Enterprise JavaBeans (EJB) summary lists all
enterprise beans running in the server, the amount of time spent in their methods, the number of EJB
invocations, and the total time spent in each enterprise
bean.
total_time = number_of_invocations * time_in_methods
Sort the various columns to find the most expensive enterprise bean. Also, if the PMI counters are enabled for individual EJB methods, select the check box next to the EJB name see statistics for each of the methods.
Tips:- Sort by Avg Response Time to find the slowest enterprise beam.
- Sort by Method Calls to find the enterprise bean used the most.
- Sort by Total Time to find the enterprise bean with the slowest response time.
- EJB Methods
- The EJB method summary shows statistics for each EJB method. Use the EJB method summary to find
the most costly methods of your enterprise beans.Tips:
- Sort by Avg Response Time to find the slowest EJB method.
- Sort by Method Calls to find the EJB method used the most.
- Sort by Total Time to find the EJB method with the slowest response time.
- Connection Pool
- The connection pool summary lists all data source connections that are defined in the
application server and shows their usage over time.Tip: When the application is experiencing normal to heavy usage, the pools used by that application should be nearly fully utilized. Low utilization means that resources are being wasted by maintaining connections or threads that are never used. Consider the order in which work progresses through the various pools. If the resources near the end of the pipeline are under utilized, it might mean that resources near the front are constrained or that more resources than necessary are allocated near the end of the pipeline.
- Thread Pool
- The thread pool summary shows the usage of all thread pools in the application server over
time.Tip: When the application is experiencing normal to heavy usage, the pools used by that application should be nearly fully utilized. Low utilization means that resources are being wasted by maintaining connections or threads that are never used. Consider the order in which work progresses through the various pools. If the resources near the end of the pipeline are under utilized, it might mean that resources near the front are constrained or that more resources than necessary are allocated near the end of the pipeline.
Performance Modules
View performance modules that provide graphics and charts of various performance data on system resources such as CPU utilization, on WebSphere Application Server pools and queues such as database connection pools, and on customer application data such as servlet response time. In addition to providing a viewer for performance data, Tivoli Performance Viewer enables you to view data for other products or customer applications that have implemented custom PMI.
Each performance module has several counters associated with it. These counters are displayed in a table underneath the data chart or table. Selected counters are displayed in the chart or table. You can add or remove counters from the chart or table by selecting or deselecting the check box next to them. By default, the first three counters for each module are shown.
In Version 8, the Tivoli Performance Viewer graph uses
Dojo Technology for plotting the performance activity rather than the Scalable Vector Graphics (SVG)
format. The Dojo format provides a better user experience and is more processor and memory efficient
for the application server. The SVG format is still supported but is deprecated in Version 8 of this
product. To use the SVG format and image format, set the JVM property to false
; for
example: com.ibm.websphere.tpv.DojoGraph=false
. If the property is set to
false
, Dojo is disabled and Tivoli
Performance Viewer displays interactive graphics using the SVG format or non-interactive graphics
using the JPG format. When you specify to use the SVG format by setting
com.ibm.websphere.tpv.DojoGraph=false
, if you do not have the Adobe SVG browser plug-in installed, you are prompted to download and install
it. If you select not to install the plug-in (by selecting Cancel), Tivoli Performance Viewer displays the static image. If your
browser is Internet Explorer 7, the Adobe SVG installation
prompt might be inaccessible. To resolve the problem, reinstall Adobe SVG. By default, this property is set to a value of true
to use the
Dojo format.
In the performance module, you view current activity. This is a real time operation where the state of various system resources and their usage is displayed. Unless logging is turned on, data generated in this scenario will not be saved and is unavailable for subsequent viewing and analysis. To monitor behavior and system resources, click Start Logging. The user can replay and analyze the file at a later time.
- Start Logging/Stop Logging
- Starts or stops logging performance data. After you start monitoring for your server, you can view real time operation in the Tivoli Performance Viewer panels.
- Reset to Zero
- Sets a new baseline using the current counter readings at the instant the button is clicked. Future data points are plotted on the graph relative to their position at the time Reset to Zero is clicked. Data points gathered prior to the time Reset to Zero is clicked are not displayed, although they are still held in the Tivoli Performance Viewer buffer. If Undo Reset to Zero is clicked again, Tivoli Performance Viewer displays all data currently in the buffer from their original baseline, not from the Reset to Zero point.
- View Table/View Graph
- To view the data in a table, click View Table on the counter selection table. To toggle back to a chart, click View Graph.
- Show Legend/Hide Legend
- To view the legend for a chart, click Show Legend. To hide the legend, click Hide Legend.
- Clear Buffer
- To clear values from the table or chart, click Clear Buffer beneath the chart or table. This removes all PMI data.