prlogging.xml file

The prlogging.xml file is a control file for the PRPC logging facility, a modified version of the Apache log4j facility.

Entries in the prlogging.xml file follow the syntax of Apache log4j xml configuration entries. For example, the following settings cause DEBUG-level logging for every agent, activity, data transform, and when condition rule:

<category name="com.pega.pegarules.engine.context.Agent">   <priority value="debug"/>
</category>
<category name="Rule_Obj_Activity">
   <priority value="debug"/>
</category>
<category name="Rule_Obj_Model">
   <priority value="debug"/>
</category>
<category name="Rule_Obj_When">
   <priority value="debug"/>
</category>

Changes

To change a logging level only temporarily, you do not need to update the file. Use the Logging Level Settings tool.

As a best practice, use application server facilities to effect permanent changes in this file:

  1. Undeploy PRPC.
  2. Extract the current prlogging.xml file from the prweb.war file (or EAR file).
  3. Edit the file as required.
  4. Repackage the WAR file or EAR file.
  5. Redeploy with the application server facilities.
  6. Restart the application server.

Rolling the log files daily

By default, the date portion of the Pega log file name and Alert log file name indicates the date the application server was recently started on the node. You can update the prlogging.xml file to cause a new log file to be created at the start of each day, known as "rolling" the log file. For details, see the Administration and Security 5.3 publication.

When PRPC is deployed as an enterprise application, the prconfig.xml file is contained in a jar file \APP-INF\lib\prresources.jar.

Related Topics IconRelated terms