LinkedIn
Copied!

Table of Contents

Service SOAP rules debugging and performance

Version:

Only available versions of this content are shown in the dropdown

Learn about the ways in which you can monitor the performance of your Service SOAP rules and debug these rules if necessary. By understanding how to debug your Service SOAP rules, you can troubleshoot errors and improve performance.

The following information also applies to Service SAP rules.

Logging

To see the full text of the request and response messages, use the Set Logging Levels tool to set logging for this Java class to INFO. You can enable the pxIntegration.Service.SOAP log category for SOAP services. For more information, see Log levels for log categories.

com.pega.pegarules.web.PRSOAPServlet

Debugging with the Tracer and TCPMon

Use the Tracer to debug Service SOAP rules. A proxy server such as TCPMon, part of the Apache Axis toolkit, shows you the content of the SOAP messages.

TCPMon does not work for secured services.

HTTP messages sent by Pega Platform might be compressed and difficult to review in Tracer and TCPMon displays. You can turn off data compression. For more information, see Tracer best practices.

To start TCPMon, install Axis on your workstation and create a Windows BAT file similar to the following:

set AXIS_LIB=C:\axis-1_1\lib
set CLASSPATH=%AXIS_LIB%\axis.jar
set CLASSPATH=%CLASSPATH%;%AXIS_LIB%\jaxrpc.jar
set CLASSPATH=%CLASSPATH%;%AXIS_LIB%\wsdl4j.jar
set CLASSPATH=%CLASSPATH%;%AXIS_LIB%\saaj.jar
set CLASSPATH=%CLASSPATH%;%AXIS_LIB%\commons-discovery.jar
set CLASSPATH=%CLASSPATH%;%AXIS_LIB%\commons-logging.jar
java org.apache.axis.utils.tcpmon

User instructions are available on the Apache Axis site. You can run TCPMon on any computer and modify the SOAP client to send the SOAP request to the host and port on which TCPMon runs. After TCPMon receives the request message, it forwards the message to the endpoint that you specify to TCPMon.

Performance statistics

Through changes to the prlog4j2.xml file, you can obtain performance statistics on the execution of services. See Performance tool — Statistics for services in the SERVICES-PAL log.

Through changes to the prconfig.xml file, you can be alerted to unusually long SOAP service operations. See How to detect lengthy service operations.

As an alternative to updating the prconfig.xml file, you can use dynamic system settings to configure your application. See Configuring dynamic system settings.

Have a question? Get answers now.

Visit the Collaboration Center to ask questions, engage in discussions, share ideas, and help others.