10 Oracle Identity Manager Logging Functions

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

• Overview of Oracle Identity Manager Logging Functions

• Setting Log Levels

10.1 Overview of Oracle Identity Manager Logging Functions

Oracle Identity Manager comes preinstalled with the ability to create log files related to the activities performed in the application. You can customize the level of information gathered in these log files, the location of these log files, and the frequency of archiving the information by using configuration files. Oracle Identity Manager also provides log files that contain standard error and standard out messages.

You can use the log files created by Oracle Identity Manager to track activities being performed in the various modules (for example, the adapter factory and the 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 response.

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. If they are, then 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 the log.properties file, which is located in the OIM_DC_HOME/xlclient/config/ directory.

10.2 Setting Log Levels

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

Oracle Identity Manager components are listed in the OIM_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 OIM_DC_HOME/xlclient/config/log.properties logging properties file as follows:

1. Open the OIM_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 are part of Oracle Identity Manager.

   By default, Oracle Identity Manager is configured to produce the 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, displayed 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 the Design Console to DEBUG:

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

4. Save your changes.

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