Oracle® Identity Manager Design Console Guide Release 9.1.0.2 E14762-01 |
|
Previous |
Next |
This chapter describes the Oracle Identity Manager logging functions. It contains the following topics:
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.
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:
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.
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
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
Save your changes.
Restart the Design Console so that the changes take effect.