Log Handler and Logger Configuration

Enabling System Logging 8-5 To make changes to log handler properties, you can use either the Fusion Middleware Control tool or the WLST command-line tool.

8.1.4 Configuring Loggers

Individual loggers are configured in the loggers section of the logging.xml file. More than twenty different Oracle Identity Manager loggers that can be configured to send messages to log handlers. Oracle Identity Manager loggers are described in Table 2 on page 7. Setting the level attribute for the logger configures the amount of detail and, hence, the volume of messages that the logger sends to its handlers. Nesting one or more handler elements inside of logger elements assigns handlers to loggers. The following excerpt shows a logger called OIMCP.PSFTCOMMON. The level attribute is set to WARNING:32 and the logger sends messages to three handlers: logger name=OIMCP.PSFTCOMMON level=WARNING:32 useParentHandlers=false handler name=odl-handler handler name=wls-domain handler name=console-handler logger A logger can inherit a parent loggers settings, including the parents level setting and other attributes, as well as the parent loggers handlers. To disable inheritance, set the useParentHandlers attribute to false, as shown in the previous excerpt. At the top of the logger inheritance tree is the root logger. The root logger is the logger with an empty name attribute, as shown in the following example. loggers logger name= level=WARNING:1 handler name=odl-handler handler name=wls-domain handler name=console-handler logger -- Additional loggers listed here -- loggers If a logger is configured with only its name attribute, the logger will inherit the rest of its attributes from the root logger, as shown in the following example: loggers logger name=oracle.iam.identity.rolemgmt -- Additional loggers listed here -- loggers To configure loggers: See Also: ■ Configuring Settings for Log Files in the Oracle Fusion Middleware Administrators Guide for information about both the Fusion Middleware Control tool and the WLST command-line tool ■ Logging Custom WLST Commands in the Oracle Fusion Middleware WebLogic Scripting Tool Command Reference for information about the WLST command-line tool 8-6 Oracle Fusion Middleware Administrators Guide for Oracle Identity Manager 1. Open the DOMAIN_NAMEconfigfmwconfigserversSERVER_NAMElogging.xml file. 2. Locate the logger you want to configure. Table 8–2 lists the Oracle Identity Manager loggers. Table 8–2 Oracle Identity Manager Loggers Logger Description oracle.iam.request oracle.iam.requestdatasetgeneration oracle.iam.requestactions oracle.iam.platform.workflowservice Logs events related to request and request dataset management. oracle.iam.requesttemplate Logs events related to request template management. oracle.iam.selfservice Logs events related to authenticated and unauthenticated self-service operations. oracle.iam.ChangePasswordtaskflow Logs events for the password change functionality UI. oracle.iam.forgotpasswordtaskflow Logs events for the forgot password functionality UI. oracle.iam.identitytaskflow Logs events for the administrative UI identity operations. oracle.iam.identity.orgmgmt Logs events related to the organization manager service operations. oracle.iam.identity.rolemgmt Logs events related to the role manager service operations. oracle.iam.identity.usermgmt Logs events related to the user manager service operations. oracle.iam.identity.scheduledtasks Logs events related to scheduled tasks in the identity feature. oracle.iam.platform.utils Logs events related to utilities provided by the platform mainly used by other features. Includes utilities for message resources handling, logging handling, internationalization, caching, and so on. oracle.iam.platformservice Logs events related to utilities that are mainly executed from the client side. For example, the plug-in registration utility, the purge cache utility, and so on. Some server-side utilities, such as the date-time utility and the exception handling utility, also use this logger. oracle.iam.platform.canonic Logs events related to the platform UI framework. oracle.iam.consoles.faces oracle.iam.consoles.common Logs messages generated from the UI framework. oracle.iam.platform.kernel Logs events related to the kernel. This includes the logging generated during the handling of orchestrations by the platform. The event handlers executed in the orchestrations within each feature use that features respective logger. oracle.iam.platform.context Logs events related to the context management feature.