PAM - Extreme Log Settings

Products

• CA Process Automation Base

Issue/Introduction

The popular log settings are outlined here: Process Automation - Increase logging levels, file size and rollover for PAM logs

This is sufficient for most issues where additional details are needed. Occasionally, more information is helpful. The steps outlined here can offer more more information - though sometimes at a cost of logging an extreme amount of data and possibly sensitive data too (example: variable values). 

 

Environment

Release : 4.3

Component : Process Automation

Resolution

If this type of logging is acceptable for a short amount of time then it is recommended to also make sure the following is true for param name="File" value="${jboss.server.home.dir}/log/c2o.log":

• param name="MaxFileSize" value="50000KB"
• param name="MaxBackupIndex" value="30"

The extreme trace settings can be described by its XPATH using the following:

• Set the tracing in PAM. To do this:
  • Create a copy of the <PAM_InstallDir>/server/c2o/conf/log4j.xml
  • Open the log4j.xml file
  • Change /log4j:configuration/appender[@name='C2OFILE']/param[@name='Threshold']/@value to TRACE
  • Change /log4j:configuration/root/priority/@value to TRACE
  • Add the following right above /log4j:configuration/root (so that  log4j:configuration/category[@name='com'] becomes a valid xpath statement:
       <category name="com">
          <priority value="ALL"/>
       </category>

Example: 

Change this section from:

   <!-- <appender name="C2OFILE" class="org.jboss.logging.appender.RollingFileAppender">
     <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/> -->
     <param name="File" value="${jboss.server.home.dir}/log/c2o.log"/>
      <param name="Threshold" value="ERROR"/>
     <param name="Append" value="true"/>
     <param name="MaxFileSize" value="50000KB"/>
     <param name="MaxBackupIndex" value="3"/>

To:

   <!-- <appender name="C2OFILE" class="org.jboss.logging.appender.RollingFileAppender">
     <errorHandler class="org.jboss.logging.util.OnlyOnceErrorHandler"/> -->
     <param name="File" value="${jboss.server.home.dir}/log/c2o.log"/>
      <param name="Threshold" value="TRACE"/>
     <param name="Append" value="true"/>
     <param name="MaxFileSize" value="50000KB"/>
     <param name="MaxBackupIndex" value="30"/>

Change this section from:

   <root>
                        <priority value="ERROR" />
                        <appender-ref ref="CONSOLE"/>
                        <appender-ref ref="C2OFILE"/>
   </root>

To: 

   <root>
                        <priority value="TRACE" />
                        <appender-ref ref="CONSOLE"/>
                        <appender-ref ref="C2OFILE"/>
   </root>

Finally, above the <root> section above, add:

   <category name="com">
      <priority value="ALL"/>
   </category>