SAP Web Dispatcher Destination Load Test

For each destination connected to the SAP Web Dispatcher, this test reports the current operational state, load, the number of connections, requests made to this destination etc.

Target of the test : A SAP Web Dispatcher

Agent deploying the test : An internal/remote agent

Outputs of the test : One set of results for each System:Destination of the SAP Web Dispatcher being monitored.

Configurable parameters for the test
Parameter	Description
Test period	How often should the test be executed
Host	Specify the host for which the test is to be configured.
Port	The port number at which the specified host listens. The default is 2375.
Data Collection Mode	By default, SAPCONTROL is chosen from this list indicating that the eG agent connects to the target SAP Web Dispatcher and collects the required metrics using the SAPControl web service. If you wish to collect the required metrics using the Command line program, then, choose CLI from this list. If you wish the eG agent to connect to the SAP Web Dispatcher Admin Login URL and collect the required metrics by scraping the URL, then, pick the WEBURL option from this list.
WSDL Port	This parameter appears only if SAPCONTROL option is chosen from the Data Collection Model list – i.e., if the test uses the SAPControl web service to collect measures. In this text box, specify the port number of the SAPControl web service. To determine the exact port number of the SAPControl web service, you can look up the etc/services file on the SAP Web Dispatcher being monitored. If the port number is not declared in the etc/services file, you can specify the default port number of the web service against WSDL Port If the web service is not SSL-enabled, then the default port number of the web service will be: 5<NR>13. Similarly, if the web service is SSL-enabled, then the default port number of the web service will be: 5<NR>14. <NR> in the port number refers to the system number of the SAP server being monitored. The system number is an indicator of the TCP/IP port at which the SAP Web Dispatcher server listens. For example, for a server that listens at port 3200, the system number will be ‘00’. Similarly, if the SAP server port is 3201, the system number will have to be specified as ‘01’. Accordingly, the default port number of an SSL-enabled SAPControl web service will be 50014 , if the system number is 00, or 50114, if the system number is 01.
SSL	This parameter appears only if SAPCONTROL is chosen from the Data Collection Mode list – i.e., if the test uses the SAPControl web service to collect measures. Set this flag to Yes, if the SAPControl web service is SSL-enabled. Set this flag to No, if the SAPControl web service is not SSL-enabled.
OS Username, OS Password and Confirm Password	This parameter appears only if SAPCONTROL is chosen from the Data Collection Mode list – i.e., if the test uses the SAPControl web service to collect measures. To enable the test to access the SAPControl web service and collect the required metrics, you need to configure the OS Username and OS Password parameters of the test with the credentials (i.e., name and password) of an OS user, who fulfills one of the following conditions: The name of the OS user should be declared using the service\admin_users profile parameter; (OR) The name of the user group to which the OS user belongs should be declared using the service\admin_groups profile parameter; (OR) The OS user should have the permission to execute the sapstartsrv executable Confirm the OS Password by retyping it in the Confirm Password text box.
WEB Dispatcher DIR	This parameter appears only if CLI is chosen from the Data Collection Mode list – i.e., if the test uses the command line program to collect measures. Specify the full path to the directory where the target SAP Web Dispatcher is installed. Ensure that the location specified contains the sapwebdisp and wdispmon executables.
Profile File	This parameter appears only if CLI is chosen from the Data Collection Mode list – i.e., if the test uses the command line program to collect measures. Specify the full path to the profile file with which the target SAP Web Dispatcher was started. The default name of the profile is sapwebdisp.pfl.
Timeout	This parameter appears only if CLI is chosen from the Data Collection Mode list – i.e., if the test uses the command line program to collect measures. Specify the time for which the eG agent should wait for collecting the required metrics. By default, this is 60 seconds.
Web Disp URL	This parameter appears only if the WEBURL option is chosen from the Data Collection Mode list. By default, the eG agent connects to the SAP Web Dispatcher Admin Login URL to collect the required metrics by scraping the URL. Therefore, specify the full path of the SAP Web Dispatcher Admin Login URL against this text box. For example, your specification can be: https://<SAP Web Dispatcher Host>:<SAP Web Dispatcher Port>/sap/wdisp/admin/public/default.htm.
Separate Login Page	This parameter appears only if the WEBURL option is chosen from the Data Collection Mode list. A separate login page may appear in your environment if the target SAP Web Dispatcher cannot authenticate you via HTTP authentication or if HTML FORM-based authentication is enabled or session-based authentication is enforced. By default, this flag is set to Yes indicating that a separate login page appears to access the target SAP Web Dispatcher. If your environment invokes a pop up window for login in order to access the target SAP Web Dispatcher, then, set this flag to No.
Web Disp Username, Web Disp Password and Confirm Password	This parameter appears only if the WEBURL option is chosen from the Data Collection Mode list. To enable the test to access the SAP Web Dispatcher Admin Login URL and collect the required metrics, you need to configure the Web Disp Username and Web Disp Password parameters of the test with the credentials (i.e., name and password) of a user with monitor privilege. To know more on how to create a new user, refer to Creating a New User with Monitor Privilege. Confirm the Web Disp Password by retyping it in the Confirm Password text box.
Detailed Diagnosis	To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option. The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled: The eG manager license should allow the detailed diagnosis capability Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.

Measurements made by the test

Measurement

Description

Measurement Unit

Interpretation

Status

Indicates whether/not this destination is valid.

The values reported by this measure and their numeric equivalents are available in the table below:

Measure Value	Numeric Value
No	0
Yes	1

Note:

This measure reports the Measure Values listed in the table above while indicating whether /not this destination is valid. However, in the graph of this measure, this measure is indicated using only the Numeric Values listed in the above table.

Capacity

Indicates the current capacity value for this destination.

Number

SAP Web dispatcher needs information about the capacity of a server in order to balance its workload in relation to the other servers. The capacity is used as an estimated value of the actual “power” of an application server.

Each application server has a capacity value for each of the services it provides (ABAP, Java). The number following DIA= or LB= is the capacity value for ABAP or Java.

For a destination in an ABAP system, the value of this measure is the number of configured work process and for a destination in a JAVA system, the value of this measure is the number of configured server nodes.

The value of this measure is taken into account by the SAP Web Dispatcher during load balancing.

Load

Indicates the current load on this destination.

Number

The value of this measure and the Capacity measure is used during load balancing of the SAP Web Dispatcher.

Current HTTP connections

Indicates the current number of HTTP connections to this destination.

Number

If the value of this measure is close to the value set against the wdisp/HTTP/ max_pooled_con parameter, then it indicates that the SAP Web Dispatcher is handling too much of load and will not be able to accept new connections anymore.

Percentage of HTTP connections

Indicates the percentage of HTTP connections to this destination.

Percentage

This measure is the ratio of the Current HTTP connections to the maximum number of HTTP connections setting.

Current HTTPS connections

Indicates the current number of HTTPS connections to this destination.

Number

If the value of this measure is close to the value set against the wdisp/HTTPS/ max_pooled_con parameter, then it indicates that the SAP Web Dispatcher is handling too much of load and will not be able to accept new connections anymore.

Percentage of HTTPS connections

Indicates the percentage of HTTPS connections to this destination.

Percentage

The value of this measure is the ratio of the Current HTTPS connections to the maximum number of HTTPS connection setting.

Stateless requests

Indicates the current number of stateless requests to this destination.

Number

Stateless requests are the requests that are assigned to the next application server in the queue in accordance with load balancing.

Request groups

Indicates the number of requests for groups in this destination.

Number

Stateful requests

Indicates the current number of stateful requests to this destination.

Number

If a stateful request is made, the system selects the application server that should process the transaction.

Response time

Indicates the average time taken by a request to this destination.

Seconds

Last ping time

Indicates the most recent response time for a ping request to this destination.

Seconds

The value of this measure can be used to detect overall load trends for the destination. A sudden/gradual increase in the value of this measure indicates bottlenecks in the destination.