Skip to main content


         This documentation site is for previous versions. Visit our new documentation site for current releases.      
 

Debugging listeners by using remote logging

Updated on May 11, 2022

For on-premises environments, you can troubleshoot listeners with more detail than is available using the Tracer by using remote logging.

You can examine the log files by using the Remote Logging feature to stream the contents of the log file to your workstation. You can watch the log as it grows while running a service rather than opening the log repeatedly.

Follow the steps in the following procedures to configure a listener or service requestor to send log messages to your workstation.

Install the log4j Remote Logging package

You can use the TcpSocketServer that comes with Log4j2. With TcpSocketServer, there is no user interface. You can control where incoming logs go using the same configurations as Log4j2. For more information, see the Log4j2 documentation. The following example shows how to configure and run TcpSocketServer:

startTCPSocketServer.cmd
java -classpath .\log4j-api-2.5.jar;.\log4j-core-2.5.jar org.apache.logging.log4j.core.net.server.TcpSocketServer 8887 tcpSocketServer.properties

Modify logging settings

The prlog4j2.xml configuration file defines the levels of logging events. In a multinode system, you can create separate prlog4j2.xml files for each node.

When you are testing services, enable logging for the com.pega.pegarules.services Java package, or use the Logging Level tool to enable logging for this package temporarily.

Have a question? Get answers now.

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

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best.

Pega.com is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us