Windows Client Logging

Overview of Logging for Windows Clients

Logging for SAS Integration Technologies Windows clients is implemented by using the log4net framework from Apache. The log4net framework enables you to manage the logging for all of your Windows clients in a single logging configuration. The log4net configuration is stored in an XML file, which can be modified by using the Integration Technologies Configuration utility (ITConfig).
The log4net configuration consists of appenders and loggers. Appenders specify how the logging information is written to the log. Loggers associate a level in the object hierarchy with one or more appenders, and set the level of detail that is included in the log.
For more information about the log4net framework, see the Apache log4net site at http://logging.apache.org/log4net/.

Editing Your Logging Configuration

The logging configuration for Windows clients is stored in a file named log4netConfig.xml. If you configure logging for specific users, then the file is located the following path:
\Documents and Settings\user-name\Application Data\SAS\WindowsClientLogging
If you use a single configuration for all users, then the file is located in the following path:
\Documents and Settings\All Users\Application Data\SAS\WindowsClientLogging
To edit your configuration, perform the following steps:
  1. Start the Integration Technologies Configuration utility by selecting Startthen selectProgramsthen selectSASthen selectSAS 9.3 License Renewal & Utilitiesthen selectIntegration Technologies Configuration.
  2. Select Configure Windows Client Logging, and then click Next.
  3. Select whether you want to configure logging for the current user (Current user only), or for all users on this machine (All users of this machine). Click Next.
  4. Select one of the following options:
    Edit the current logging configuration file specifies that you want to edit the current configuration.
    Load default settings specifies that you want to edit a new configuration based on the default settings.
    Enable logging if your configuration was previously disabled, then this option re-enables the current logging configuration and enables you to edit it.
    Click Next.
  5. In the Configure Logging Appenders window, create the logging appenders that you want to use. For each appender, specify the following information:
    Name specifies the name of the appender.
    Layout specifies a formatting string that controls the output.
    Type specifies the type of appender. The appender type determines where the output is sent. For example, EventLogAppender sends output to the Windows Event Log. FileAppender writes output to a file.
    You can also click Filters to define filters for the appender. Filters enable you to send only the output that matches certain criteria. At the bottom of the list of filters, you must add a DenyAllFilter filter to remove the output that does not match the other filter.
    Depending on the appender type that you specify, additional information might be required. For more information about the information that you can specify, see the Integration Technologies Configuration Help.
    When you are finished defining appenders, click Next.
  6. In the Configure Loggers window, create the loggers that you want to use. For each logger, the name specifies the logging namespace for the logger. You can select the standard SAS namespaces from the drop-down list or specify a custom namespace. The root logger specifies the default logging settings for Windows clients. For each logger, specify the level of logging detail and the appenders that are associated with the logger.
    If you want a logger to exclude its contents from any parent loggers, then select Enable Appender Additivity. For example, if you create a logger for SAS.BI and a logger for SAS.BI.Metadata, then select Enable Appender Additivity for the SAS.BI.Metadata logger if you do not want its content to also appear in the SAS.BI logger.
    For more information about specifying loggers, see the Integration Technologies Configuration Help.
    When you are finished defining loggers, click Save to save your configuration file.

Disabling Windows Client Logging

To disable logging for SAS Integration Technologies Windows clients, perform the following steps:
  1. Start the Integration Technologies Configuration utility by selecting Startthen selectProgramsthen selectSASthen selectSAS 9.3 License Renewal & Utilitiesthen selectIntegration Technologies Configuration.
  2. Select Configure Windows Client Logging, and then click Next.
  3. Select whether you want to configure logging for the current user (Current user only), or for all users on this machine (All users of this machine). Click Next.
  4. Select Disable logging, and then click Finish.dd