Remote logging - log4j2 - 2.11.1
Referencing the help article:
The article references to download the log4j package, which is generally avalable from apache, however as of now, the latest version of the package is 2.11.1. It also looks like the tcpSocketServer feature has been removed from v2.9.1
Do we have updated guidelines on how to perform remote logging with more recent packages?
Currently executing:
java -classpath .\log4j-api-2.11.1.jar;.\log4j-core-2.11.1.jar org.apache.logging.log4j.core.net.server.TcpSocketServer 8887 tcpSocketServer.properties
returns
Error: Could not find or load main class org.apache.logging.log4j.core.net.server.TcpSocketServer
Pegasystems Inc.
IT
Hello @EugeneR7
As you said in recent Log4j2 versions the org.apache.logging.log4j.core.net.server.TcpSocketServer class has been moved in a separate project: logging-log4-tools which is not yet released: https://stackoverflow.com/a/47784395
However working with newer Log4J versions of that class is not recommended as the TcpSocketServer and the wire format has changed in the meantime and will not work correctly with the Log4J2 version shipped with Pega.
The recommended approach is to user the TcpSocketServer version from Log4J 2.6.2 that matches the version shipped with Pega since version 7.3.
To do so you need to download the required jars below from Maven Central Repository:
Then you can run the TcpSocketServer class using the following steps:
Hello @EugeneR7
As you said in recent Log4j2 versions the org.apache.logging.log4j.core.net.server.TcpSocketServer class has been moved in a separate project: logging-log4-tools which is not yet released: https://stackoverflow.com/a/47784395
However working with newer Log4J versions of that class is not recommended as the TcpSocketServer and the wire format has changed in the meantime and will not work correctly with the Log4J2 version shipped with Pega.
The recommended approach is to user the TcpSocketServer version from Log4J 2.6.2 that matches the version shipped with Pega since version 7.3.
To do so you need to download the required jars below from Maven Central Repository:
Then you can run the TcpSocketServer class using the following steps:
prompt> set LIB_DIR=c:\Pega\RemoteServer\Log4J2
prompt> java -Dpega.log.location=%LIB_DIR%\logs -cp %LIB_DIR%\log4j-api-2.6.2.jar;%LIB_DIR%\log4j-core-2.6.2.jar org.apache.logging.log4j.core.net.server.TcpSocketServer 12345 %LIB_DIR%\prlog4j2.xml
Notes:
- LIB_DIR is system variable where the jars are expected
- Java System Property pega.log.location is used in the Log4J configuration file prlog4j2.xml to determine the log files path
- TcpSocketServer listens on port 12345
- %LIB_DIR%\prlog4j2.xml is the Log4J configuration file (attached for reference)
Then in System Management Application select a node, Select the Logging and Tracing > Remote Logging menu item. Then provide the remote host and port (12345 in this example) and click on add.
In the directory identified by the pega.log.location property you should see the following files:
- PegaRULES-SecurityEvent.log
- PegaRULES-ALERTSECURITY.log
- PegaRULES-ALERT.log
- PegaRULES.log
- PegaCLUSTER.log
- PegaBIX.log