When you debug problems with SAS Enterprise Case Management, it is helpful to have thread, millisecond, and response time information in the SAS Enterprise Case Management and localhost access logs. This information enables you to correlate information across multiple log files more easily. The millisecond information is also helpful when you are investigating performance problems.
Follow the steps below to update the SAS Enterprise Case Management log and the localhost access logs for SASServer1 and SASServer8. These changes are recommended for versions of SAS Enterprise Case Management that run on SAS® 9.4.
1. Update your SAS Enterprise Case Management log configuration file.
- Locate your SAS Enterprise Case Management log configuration file.
- SAS-configuration-directory\Lev<num>\Web\Common\LogConfig\SASEntCaseManagement-log4j
- Make a backup of the file.
- Add thread and millisecond time precision.
- [%t] - adds thread information inside square brackets.
- %d{ISO8601} - includes date and time with millisecond precision.
The following example shows how to add thread and millisecond precision in the SAS Enterprise Case Management log configuration file:
Before adding the precision:
<param name="ConversionPattern" value="SASEntCaseManagement %d{ddMMMyy HH:mm:ss} %-5p %c %x - %m%n" />
After adding the precision:
<param name="ConversionPattern" value="SASEntCaseManagement %d{ISO8601} %-5p [%t] %c %x - %m%n" />
2. Update your localhost access log configuration files for server1 and server8.
- Locate your localhost access log configuration file for SAS Server 1 and SAS Server 8.
- SAS-configuration-directory\Lev<num>\Web\WebAppServer\SASServer1_1\conf\server.xml
- SAS-configuration-directory\Lev<num>\Web\WebAppServer\SASServer8_1\conf\server.xml
- Make a backup of the files.
- Add thread, response time, and millisecond time precision.
- I - adds thread information
- D - adds response time information
- [%{dd/MMM/yyyy:HH:mm:ss.SSS Z}t] - adds millisecond precision
The following example shows how to add thread, response time, and millisecond precision in a localhost access log configuration file:
Before adding the precision:
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" pattern="%h %l %u %t "%r" %s %b" prefix="localhost_access_log." suffix=".txt"/>
After adding the precision:
<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs" pattern="%h %l %u [%{dd/MMM/yyyy:HH:mm:ss.SSS Z}t] "%r" %s %b %D %I" prefix="localhost_access_log." suffix=".txt"/>
3. Restart your web services.
- Restart SASServer8 if you modified the SAS Enterprise Case Management log configuration file or the localhost access log file for SASServer8. If you also modified the localhost access log for SASServer1, you must restart all of your mid-tier servers.
4. Confirm your changes.
- Log on to SAS Enterprise Case Management, and then search for the changes in the log files where you expect to see debugging information.