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 Monitoring and Tuning > Performance Viewer > Current activity > server_name.

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.

The Data Monitoring panel enables the selection of multiple counters and displays the resulting performance data for the associated resources. It consists of two panels:
  • 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.

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:
Raw
Displays the absolute value. If the counter represents load data, for example, the average number of connections in a database pool, then Tivoli Performance Viewer displays the current value.
Change in Value
Displays the change in the current value from the previous value.
Rate of Change
Displays the ratio change/(T1 - T2), where change is the change in the current value from the previous value, T1 is the time when the current value was retrieved, and T2 is the time when the previous value was retrieved.

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.