Using the AGate Performance Monitor (SAP Library - ITS Tuning and Troubleshooting Guide)

Using the AGate Performance Monitor

Use

You use this procedure to monitor AGate performance with the AGate performance monitor in ITS Administration.

The functions of the AGate performance monitor allow you to:

Display performance data for local and remote AGate instances in one AGate group connected to a particular WGate
Display performance data for each AGate process and AGate process workthread
Display accumulated performance data since AGate startup

This includes thread usage info, transaction counters, SAP GUI for HTML browser data and HTML template cache counters.

Display a list of user sessions
Display a snapshot of current workthread activity
Reset all performance monitor counters to their zero values

Note

Before you can display any of these statistics, you must enable the AGate performance monitor explicitly in ITS Administration.

Procedure

Start ITS Administration.

Enable the AGate performance monitor by taking the following steps:

Select an ITS instance and choose an AGate server hosted at the local machine.
Choose Configuration.
Choose Registry.
Choose CCMS.

You see a screen similar to the following:

This graphic is explained in the accompanying text

Enable the AGate performance monitor by setting the following parameter to 1:

Parameter	Description
PerfMonitoring	0	Performance monitoring switched off (default).
	1	Performance monitoring switched on.
PerfTimeLoadShm	Frequency in seconds that performance data is written to shared memory. The default value is 10.
PerfRemoteProcesses	Defines the number of remote AGate processes, for which you wish to display monitoring information. The default value is 2.

When you change this parameter, the change takes effect after the next AGate instance restart. Setting PerfMonitoring to 1 has no noticeable impact on performance, so you can use it in production systems.

On restart, select the relevant ITS instance and choose the same AGate server again.
Choose Performance.

You see several functions in an expanded directory structure.

This graphic is explained in the accompanying text

If there are multiple AGate processes at the current host, you can run these functions for each process.

Choose a function.

To monitor cumulative performance of the ITS instance over a specified period of time, choose Performance History.

ITS Administration prompts you to enter the desired time interval.

This graphic is explained in the accompanying text

Specify the following:

Start Date and Time

End Date and Time

The start and end dates and times are inclusive

Graph type (if you want a graph display)

You can specify Averages (the average value for each time interval displayed) or Peaks (the maximum value for each interval).

Choose View Performance Log or View Performance Graph.

If you choose View Performance Log, you see a screen similar to the following:

This graphic is explained in the accompanying text

If you choose View Performance Graph, you see a graphical representation of the above information.

To display a summary of current performance for the ITS instance across all AGate processes, choose Performance Summary

You see a screen similar to the following:

This graphic is explained in the accompanying text

The three sections in this table contain:

Header section with AGate configuration details
Current performance details for each process
Total performance details for each process

The fields are described in the following table:

Field	Description
PID	Process ID.
TAT	Turnaround time.
Total	Total time for AGate + Wait + R/3 + Browse.
AGate	Time taken within AGate.
Wait	Time taken by dispatcher to assign request to a workthread.
R3	Time taken to send a request to R/3 and receive a response.
Browse	Time taken to send results to Web browser via WGate and Web server.
Kernel	Kernel CPU time usage.
User	User CPU time usage.

To display accumulated performance data since AGate startup, including workthread counters, transaction counters, SAP GUI for HTML Web browser data and HTML template cache statistics for each AGate process, choose Performance Details

You see a screen similar to the following:

This graphic is explained in the accompanying text

The fields are described in the following table:

Field	Description
PID	Process ID.
Maximum	Maximum number of workthreads that can be used.
Current	Current number of workthreads used.
Created/Destroyed	Number of times that a workthread has been dynamically created and destroyed during peak loads of the AGate.
Transactions	Number of Web transactions executed.
Block Length	Average length of a block sent from R/3 (in bytes).
Blocks/Transaction	Average number of blocks per transaction.
Average Rendering Time	Average time taken to render an HTML page in the Web browser.
Average Request Time	Average time taken by a request, including the rendering time.
Requests	Number of requests.
Requests	Number of requests made to cached templates.
Found	Number of templates found in the cache.
Percentage	Percentage of templates found in the cache.

To display a list of active user sessions for each AGate process, choose User Sessions

You see a screen similar to the following:

This graphic is explained in the accompanying text

The fields are described in the following table:

Field	Description
Session	Session ID.
Use	Session use flag.
Service	AGate service.
Client	R/3 client.
User	R/3 user.
Transaction	R/3 transaction or RFC/BAPI called.
SID R/3	System ID.

To display a snapshot of current workthread activity, choose Thread Snapshot

You see a screen similar to the following:

This graphic is explained in the accompanying text

The fields are described in the following table:

Field	Description
TID	Thread ID.
Status	Step executed in workthread.
Client	R/3 client.
User	R/3 user ID.
Transaction	R/3 transaction or RFC/BAPI call.
ETime	Time since request was received by Agate.
KTime	Kernel CPU usage.
UTime	User CPU usage.

To display performance data for each workthread in a particular AGate process since AGate startup, choose Thread Performance

You see a screen similar to the following:

This graphic is explained in the accompanying text

The fields are described in the following table:

Field	Description
PID	Process ID.
TID	Workthread ID.
Total	Total time for AGate + Wait + R/3 + Browse.
AGate	Time taken within AGate.
Wait	Time taken by dispatcher to assign request to a workthread.
R3	Time taken to send a request to R/3 and receive a response.
Browse	Time taken to send results to Web browser via WGate and Web server.
Kernel	Kernel CPU time usage.
User	User CPU time usage.

To reset all performance monitor counters for a particular AGate process to their initial values, choose Counter Reset

You see a screen similar to the following:

This graphic is explained in the accompanying text

To reset, choose Refresh.

For an online description of the information displayed by the above functions, choose Help and select the required function.

For more detailed information about the AGate performance monitor, see ITS Installation Tuning.