11 Oracle Identity Manager Logging Functions

This chapter describes the Oracle Identity Manager logging functions. It contains the following topics:

• Overview

• Setting Log Levels

Overview

Oracle Identity Manager comes pre-installed with the ability to create log files related to the activities performed in the application. You can customize the level of information that is placed in these log files, the location where these log files reside, and the frequency of archiving the information in these files using configuration files. Oracle Identity Manager also provides logs files that contain standard error and standard out messages.

You can use the logs files created by Oracle Identity Manager to track activities being performed in the various modules (for example, adapter factory, task scheduler) of the application and monitor error messages and queries performed against the database. Both of these activities can be helpful when troubleshooting potential problems or testing anticipated application behavior.

You can control the following:

• The level of information, that is, greater or lesser amount of detail, that is written to the logs.

• Whether the logs are periodically archived and, if so, if they should be archived based on a user-specified time range or maximum file size.

• The location in which the log file will be placed.

Log file locations and properties are controlled by a properties file named log.properties, which is located in the <XL_DC_HOME>/xlclient/config/ directory.

Setting Log Levels

Oracle Identity Manager uses log4j for logging. Logging levels for Design Console are configured in the <XL_DC_HOME>\xlclient\config\log.properties logging properties file. By default, all Oracle Identity Manager components are configured to output at the Warning level. You can change the log level universally for all components or for an individual component, such as Design Console.

Oracle Identity Manager components are listed in the <XL_DC_HOME>\xlclient\config\log.properties file in the XELLERATE section, for example:

log4j.logger.XELLERATE=WARN
log4j.logger.XELLERATE.DDM=DEBUG
log4j.logger.XELLERATE.ACCOUNTMANAGEMENT=DEBUG
log4j.logger.XELLERATE.SERVER=DEBUG
log4j.logger.XELLERATE.RESOURCEMANAGEMENT=DEBUG
log4j.logger.XELLERATE.REQUESTS=DEBUG
log4j.logger.XELLERATE.WORKFLOW=DEBUG
log4j.logger.XELLERATE.WEBAPP=DEBUG
log4j.logger.XELLERATE.SCHEDULER=DEBUG
log4j.logger.XELLERATE.SCHEDULER.Task=DEBUG
log4j.logger.XELLERATE.ADAPTERS=DEBUG
log4j.logger.XELLERATE.JAVACLIENT=DEBUG
log4j.logger.XELLERATE.POLICIES=DEBUG
log4j.logger.XELLERATE.RULES=DEBUG
log4j.logger.XELLERATE.DATABASE=DEBUG
log4j.logger.XELLERATE.APIS=DEBUG
log4j.logger.XELLERATE.OBJECTMANAGEMENT=DEBUG
log4j.logger.XELLERATE.JMS=DEBUG
log4j.logger.XELLERATE.REMOTEMANAGER=DEBUG
log4j.logger.XELLERATE.CACHEMANAGEMENT=DEBUG
log4j.logger.XELLERATE.ATTESTATION=DEBUG
log4j.logger.XELLERATE.AUDITOR=DEBUG

To set Design log levels, edit the <XL_DC_HOME>\xlclient\config\log.properties logging properties file as follows:

1. Open the <XL_DC_HOME>\xlclient\config\log.properties file in a text editor. This file contains a general setting for Oracle Identity Manager and specific settings for the components and modules that comprise Oracle Identity Manager.

   By default, Oracle Identity Manager is configured to output at the Warning level:

   log4j.logger.XELLERATE=WARN
   
   

   This is the general value for Oracle Identity Manager. Individual components and modules are listed following the general value in the properties file. You can set individual components and modules to different log levels. The log level for a specific component overrides the general setting.

2. Set the general value to the desired log level. The following is a list of the supported log levels, appearing in descending order of information logged (DEBUG logs the most information and FATAL logs the least information):

   • DEBUG

   • INFO

   • WARN

   • ERROR

   • FATAL

3. Individual components or modules can have different log levels. For example, the following values set the log level for Design Console to DEBUG:

   log4j.logger.XELLERATE=WARN
   log4j.logger.XELLERATE.ACCOUNTMANAGEMENT=INFO
   log4j.logger.XELLERATE.JAVACLIENT=DEBUG
   
   

4. Save your changes.

5. Restart Design Console so that the changes take effect.