Configure Tivoli Performance Viewer settings

Configure Tivoli Performance Viewer settings

We can configure user and logging settings of the Tivoli Performance Viewer (TPV). Configuring the TPV settings affects the performance of the application server. TPV monitors the performance activity of all servers on a node. The data can also be viewed from the deployment manager. We can configure the activity monitoring of Tivoli Performance Viewer on a per-user basis. Any changes made to Tivoli Performance Viewer settings are only for the server being monitored and only affect the user viewing the data. We can change the user and log TPV settings in the administrative console.

Configure Tivoli Performance Viewer 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.
Click...
Monitor and Tuning > Performance Viewer > Current Activity > server > Sets > Log

To see the Log link on the Tivoli Performance Viewer page, expand the Settings node of the Tivoli Performance Viewer navigation tree. After clicking Log, the Tivoli Performance Viewer log settings are displayed.
Change the values as needed for the log settings.

Setting Description
Duration 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 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 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 stored is constrained by the Maximum File Size and Maximum Number of Historical Files parameters.
File Name 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 Whether Tivoli Performance Viewer writes log files as XML or in a binary format. Binary format provides a smaller log file when uncompressed and is recommended if space is a consideration.

Click Apply.

Configure the Tivoli Performance Viewer user settings

In the console navigation tree...
Monitor and Tuning > Performance Viewer > Current Activity > server > Sets > User

To see the User link on the Tivoli Performance Viewer page, expand the Settings node of the Tivoli Performance Viewer navigation tree. After clicking User, the Tivoli Performance Viewer user settings are displayed.
...and change the values as needed for the user settings.

Setting Description
Refresh Rate How frequently TPV 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 Number of entries to be stored for a server. Data displayed in TPV 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 entries. Supported 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 How counter values are displayed. Viewing options include the following:

Raw Value Display the absolute value. If the counter represents load data, such as the average number of connections in a database pool, then TPV displays the current value followed by the average. For example, 18 (avg:5).
Change in Value Display the change in the current value from the previous value.
Rate of Change Display 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.

The refresh rate and buffer size settings combine to control how much temporal history we have for the application server. The default values for Refresh Rate (30 seconds) and Buffer Size (40 entries) provide you with a 20-minute history of the application server's performance. Changing one of these parameters affects the length of the temporal history. The values set for Refresh Rate and Buffer Size depend on your use of TPV. To diagnose a known problem on a test machine, we might poll data more frequently while having a decreased buffer size. To monitor a production server, we might poll data less frequently and specify a buffer size depending on how much history we want. However, TPV is not intended to be a full-time monitoring solution.

Click Apply.

See also

View current performance activity
Monitor performance with Tivoli Performance Viewer
View Data with the Tivoli Performance Viewer
Select a server and change monitoring status

Setting	Description
Duration	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	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	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 stored is constrained by the Maximum File Size and Maximum Number of Historical Files parameters.
File Name	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	Whether Tivoli Performance Viewer writes log files as XML or in a binary format. Binary format provides a smaller log file when uncompressed and is recommended if space is a consideration.