24.5 Configuring the Log and Trace Levels of Drivers

To configure log and trace for your drivers, select the Drivers > Log & Trace Configuration tab from the Identity Console main page. This section is divided into the following categories:

24.5.1 Configuring Log Level

Each driver has a log level field where you can define the level of errors that should be tracked. The level you indicate here determines which messages are available to the logs. By default, the log level is set to track error messages. (This also includes fatal messages.) To track additional message types, change the log level. To configure the log level, select the Log & Trace Configuration > Log Level tab. The following table describes the log level settings:

Option

Description

Use log settings from the Driver Set

If this is selected, the driver logs events based on the log settings of the Driver Set object.

Turn off logging to Driver Set, Subscriber and Publisher logs

Turns all logging off for this driver on the Driver Set object, Subscriber channel, and the Publisher channel.

Maximum number of entries in the log (50-500)

Number of entries in the log. The default value is 50.

Log Levels

The following log levels are available to select:

  • Log errors: Logs just errors

  • Log errors and warnings: Logs errors and warnings

  • Log specific events: Logs the events that are selected. Selecting this option enables the following list of events:

    • Metadirectory Engine Events

    • Status Events

    • Operation Events

    • Transformation Events

    • Credential Provisioning Events

  • Only update the last log time: Updates the last log time.

  • Logging Off: Turns logging off for the driver.

24.5.2 Configuring Trace Level

You can configure trace for a specific driver. Depending on the trace level specified for a driver, trace displays driver-related events when the engine processes the events. The driver trace level affects only the driver or driver set where trace is set. If you are using the Remote Loader, the Remote Loader trace file is set directly on the Remote Loader and contains only the driver shim trace.

To configure trace for a driver, select the Log & Trace Configuration > Trace tab. The following table describes the trace settings:

Parameter

Driver

Trace level

As the driver trace level increases, the amount of information displayed in Trace increases.

Trace level one shows errors, but not the cause of the errors. If you want to see password synchronization information, set the trace level to five.

If you select Use setting from Driver Set, the value is taken from the driver set.

Trace file

Specify a file name and location of where the Identity Manager information is written for the selected driver.

If you select Use setting from Driver Set, the value is taken from the driver set.

Trace name

The driver trace messages are pre-pended with the value entered instead of the driver name. Use if the driver name is very long.

Trace file encoding

The trace file uses the system’s default encoding. You can specify another encoding if desired.

Trace file size limit

Allows you to set a limit for the Java trace file. If you set the file size to unlimited, the file grows in size until there is no disk space left.

NOTE:If the file size limit is specified the trace file is created in multiple files. Identity Manager automatically divides the maximum file size by ten and creates ten separate files. The combined size of these files equals the maximum trace file size.

If you select Use setting from Driver Set, the value is taken from the driver set.

Figure 24-5 Managing Log and Trace Levels of Drivers