4.1 Selecting Events to Log

The Identity Manager Instrumentation allows you to select events to be logged for a driver set, a specific driver, or for the User Application. The User Application consists of the User Application driver, the Role Based Provisioning driver, and workflows.

NOTE:Drivers can inherit logging configuration from the driver set.

The following sections document how to select events for the User Application, driver set, or a specific driver:

4.1.1 Selecting Events for the User Application

The User Application enables you to change the log level settings of individual loggers and enable logging to the Identity Audit Platform Agent:

  1. Log in to the User Application as the User Application Administrator.

  2. Select the Administration tab.

  3. Select the Logging link.

    The Logging Configuration page appears.

    Logging options in the User Application

  4. Select one of the following log levels for the listed logs.

    Log Level

    Description

    Fatal

    Writes Fatal level messages to the log.

    Error

    Writes Fatal and Error level messages to the log.

    Warn

    Writes Fatal, Error, and Warn level messages to the log.

    Info

    Writes Fatal, Error, Warn, and Info level messages to the log.

    Debug

    Writes Fatal, Error, Warn, Info, and debugging information to the log.

    Trace

    Writes Fatal, Error, Warn, Info, debugging, and tracing information to the log.

  5. Select the Also send logging messages to Identity Audit check box to send the events to the Platform Agent.

  6. (Optional) Select Also send logging messages to Open XDAS, if you want to send the messages to Open XDAS.

    For this option to work, you must select the open XDAS option during the installation of the User Application. For more information, see the User Application Installation Guide.

  7. To save the changes for any subsequent User Application server restarts, select Persist the logging changes.

  8. Click Submit.

The User Application logging configuration is saved in installdir/jboss/server/IDMProv/conf/idmuserapp_logging.xml.

4.1.2 Selecting Events for the Driver Set

  1. In iManager, select Identity Manager > Identity Manager Overview.

  2. Browse to and select the driver set.

  3. Click the driver set object in the list of driver sets, then click Driver Set > Edit Driver Set properties.

    Editing the properties of the driver set

  4. Select the Log Level tab, then select a log level for the driver set.

    For an explanation of each log level, see Identity Manager Log Levels.

    Driver set log levels

  5. Click Apply or OK to save your changes.

NOTE:Changes to configuration settings are logged by default.

4.1.3 Selecting Events for a Specific Driver

  1. In iManager, select Identity Manager > Identity Manager Overview.

  2. Browse to and select the driver set.

  3. Click the driver set to view the driver set overview page.

  4. Click the upper right corner of the driver icon, then select Edit properties.

    Editing the driver properties

  5. Select Log Level on the driver’s properties page.

  6. (Optional) By default, the Driver object is configured to inherit log settings from the Driver Set object. To log events for this driver only, deselect Use log settings from the Driver Set.

    Option to select if the list of logged events should be inherited

  7. Select a log level for the current driver.

    For an explanation of each log level, see Identity Manager Log Levels.

  8. Click Apply or OK to save your changes.

NOTE:Changes to configuration settings are logged by default.

4.1.4 Identity Manager Log Levels

The following table provides an explanation of the Identity Manager Instrumentation log levels:

Table 4-1 Identity Manager Instrumentation Log Levels

Option

Description

Log errors

This is the default log level. The Identity Manager Instrumentation logs user-defined events and all events with an error status.

You receive only events with a decimal ID of 196646 and an error message stored in the Text1 field.

Log errors and warnings

The Identity Manager Instrumentation logs user-defined events and all events with an error or warning status.

You receive only events with a decimal ID of 196646 or 196647 and an error or warning message stored in the first text field.

Log specific events

This option allows you to select the Identity Manager events you want to log.

Click Log event icon to select the specific events you want to log. After you select the events you want to log, click OK.

NOTE:User-defined events are always logged.

For a list of all available events, see Section A.0, Identity Manager Events.

Only update the last log time

The Identity Manager Instrumentation logs only user-defined events.

When an event occurs, the last log time is updated so you can view the time and date of the last error in the status log.

Logging off

The Identity Manager Instrumentation logs only user-defined events.

Turn off logging to DriverSet, Subscriber and Publisher logs

Turns off logging to the Driver Set object, Subscriber, and Publisher logs.

Maximum Number of Entries in the Log

This setting allows you to specify the maximum number of entries to log in the status logs. See Section 5.2, Viewing Status Logs for details.