Usage Note 50483: Enabling debug logging in SAS® Customer Intelligence 6.1 General Availability (GA) and 6.1_M1
Note: Enabling debug logging in SAS Customer Intelligence 6.3 is performed by setting the logging level on the Environment Variables page, as described in the "Set Logging Level" section at page 33 of "Chapter 2: Administration" in the SAS® Marketing Automation 6.3: Administrator’s Guide
You can change logging output locations and levels for SAS Customer Intelligence 6.1. However, the steps that are described in "Chapter 16: Troubleshooting" of the SAS® Marketing Automation 6.1 and SAS® Real-Time Decision Manager 6.1: Administrator’s Guide reference an incorrect SAS note. Instead, follow the steps that are described later in "Steps for Changing Logging Output Locations and Levels."
Before you begin the steps, note the following:
- With SAS Customer Intelligence 6.1 GA, the XML files are incorrect. You should follow the instructions in this SAS note and download the correct XML files that are included in this note.
- With a new SAS Customer Intelligence 6.1_M1 installation, the XML files are set to DEBUG as a standard and all the missing tags are included.
- When you upgrade from SAS Customer Intelligence 6.1 GA to 6.1_M1, the correct XML files do not overwrite the incorrect files.
You need to use the files that are included in this SAS note.
- In both SAS Customer Intelligence 6.1 GA and 6.1_M1, changing the logging level in the Environment Variables dialog box as described in "Chapter 16 – Troubleshooting" of the SAS Marketing Automation 6.1 and SAS Real-Time Decision Manager 6.1 Administrator’s Guide does not work correctly. It does not matter which environment variables you choose (for example, Off, Medium, or High), the XML files do not change.
This is described in SAS Note 53444, "Changing the logging options in the Environment Variables dialog box in SAS® Customer Intelligence Studio does not work as expected."
- By default in release 6.1_M1, the value for the logging levels in the XML files is set to DEBUG. If you want to modify the logging level, you need to edit the XML files and change value for the logging level to INFO.
Steps for Changing Logging Output Locations and Levels
- The following files are located in the \SAS\Config\Lev1\Web\Common\LogConfig directory:
- SASCustIntelStudio-log4j.xml
- SASCustIntelReporting-log4j.xml
- SASCustIntelCore-log4j.xml
- SASMarketingOptimization-log4j.xml
- SASDigitalMarketingWebStudio-log4j.xml
-
To enable debugging, you need to modify the values manually in the XML files listed above by changing INFO to DEBUG, as shown in the following example:
<logger name="com.sas.analytics.crm" additivity="false">
<level value="DEBUG"/>
<appender-ref ref="SAS_FILE"/>
</logger>
Note: SAS Technical Support recommends that you only modify the value for com.sas.analytics.crm.
-
To enable the macro code, you should modify the value shown in the example below:
<logger name="com.sas.ci.saslogging" additivity="false">
<level value="DEBUG"/>
<appender-ref ref="SAS_FILE"/>
</logger>
This is the same as the Display macro code option that is available in previous releases.
-
Save the following sample XML files (right-click the file and select Save target as):
Note:
When you use the sample XML files, you might need to modify the File value to match your installation:
param name="File" value="C:/SAS/Config/Lev1/Web/Logs/
- Restart SAS® Remote Services, which also includes restarting all of the
web servers (for example, SASServer1 and SASServer6) once, so that these modifications take effect.
Operating System and Release Information
SAS System | SAS Marketing Automation | Microsoft® Windows® for x64 | 6.1 | | | |
64-bit Enabled AIX | 6.1 | | | |
64-bit Enabled HP-UX | 6.1 | | | |
64-bit Enabled Solaris | 6.1 | | | |
HP-UX IPF | 6.1 | | | |
Linux for x64 | 6.1 | | | |
Solaris for x64 | 6.1 | | | |
*
For software releases that are not yet generally available, the Fixed
Release is the software release in which the problem is planned to be
fixed.
Date Modified: | 2013-07-23 16:27:51 |
Date Created: | 2013-07-23 11:38:18 |