SOAP Statistics Test

SOAP is a lightweight, XML-based protocol used for exchanging information in a decentralized, distributed environment. SOAP can be used to query and return information and invoke services across the internet.

For each SOAP URL/service integrated with the target IBM Integration Bus, this test reports how well messages are sent/received from the SOAP client. This test is therefore useful for administrators to identify the load on the SOAP client and figure out the errors that occurred when messages are sent to the message flow. This way administrators may be proactively alerted to processing bottlenecks in the SOAP client.

Target of the test : An IBM Integration Bus

Agent deploying the test : An internal/remote agent.

Outputs of the test : One set of results for each Execution group: SOAP URL/service of the IBM Integration Bus that is to be monitored

Configurable parameters for the test
Parameters	Description
Test period	How often should the test be executed.
Host	The host for which the test is to be configured.
Port	The port on which the specified host listens.
JNDI Namespace Location	Indicate where the JNDI namespace has been created. For this, select one of the following options: File or LDAP. Select File if the JNDI namespace is created in the same location as that of the IIB server.
SSL	If you have chosen LDAP as the JNDI Namespace Location wherein the LDAP server communicating with the IIB server that is to be monitored is an SSL-enabled server, then set the SSL flag to Yes. By default, this flag is set to No.
User DN and Password	Here, provide the credentials of the Active Directory user created as explained in Creating a user in the Active Directory server, if the target IIB server is monitored in an agentless manner. If the IIB server is to be monitored in an agent based manner, specify none against these parameters.
Confirm Password	Confirm the Password by retyping it in this text box.
JNDI Provider URL	Specify the URL that was specified as the provider URL while creating the initial context. To know the Provider URL, refer to Agent based monitoring of the IIB server if you choose to monitor the target IIB server in an agent based manner and Agentless Monitoring of the IIB server if you chose to monitor the target IIB server in an agentless manner.
TopicConnectionFactory	Specify the name of the connection factory in this text box. If you have chosen to monitor the target IIB server in an agent-based manner, refer to Creating a Connection Factory and if you have chosen to monitor the target IIB server in an agentless manner, refer to Creating a Connection Factory.
JMS Resource Stats	Specify the name of the JMS destination that you have created for storing the Resource statistics. If you chose to monitor the target IIB server in an agentless manner, refer to Creating the JMS Destinations and if you choose to monitor the target IIB server in an agent based manner, refer to Agent based monitoring of the IIB server.
JMS Flow Stats	Specify the name of the JMS destination that you have created for storing the Message flow statistics. If you chose to monitor the target IIB server in an agentless manner, refer to Creating the JMS Destinations and if you choose to monitor the target IIB server in an agent based manner, refer to Agent based monitoring of the IIB server.

Measurements made by the test
Measurement	Description	Measurement Unit	Interpretation
Inbound message rate	Indicates the rate at which messages are received from the SOAP client through this service during the last measurement period.	Messages/sec	Ideally, the value of this measure should be high. A consistent decrease in this value indicates that there is a delay while reading messages from the SOAP client. Further investigation may be required to diagnose the root-cause of the slowdown.
Replies sent rate	Indicates the rate at which replies are sent to the SOAP client from the SOAP Reply node through this service during the last measurement period.	Replies/sec
Flow throughput	Indicates the rate at which messages were sent to the message flow through this service without any faults during the last measurement period.	Messages/sec	This measure is a good indicator of the load on the SOAP client.
Inbound messages faulted before flow	Indicates the number of messages through this service that faulted before reaching the message flow during the last measurement period.	Number	Ideally, the value of this measure should be zero.
Inbound messages faulted rate	Indicates the rate at which messages through this service faulted before reaching the message flow during the last measurement period.	Messages/sec	Ideally, the value of this measure should be zero.
Fault replies sent	Indicates the number of faulty replies sent through this service during the last measurement period.	Number	The faulty replies may be user defined or broker exceptions.
Fault replies rate	Indicates the rate at which faulty replies were sent through this service during the last measurement period.	Replies/sec	The faulty replies may be user defined or broker exceptions.