23.4 Configuring the Log and Trace Levels of Driver Sets

To configure log and trace for your driver sets, select IDM Administration > Click the context menu (three dots) of the appropriate Driver Set > Driver Set Properties > Log & Trace Configuration tab from the Identity Console main page. This section is divided into the following categories:

23.4.1 Configuring Log Level

Each driver set 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 In Identity Console, select IDM Administration > Click the context menu (three dots) of the appropriate Driver Set > Driver Set Properties > Log & Trace Configuration > Log Level. The following table describes the log level settings:

Option

Description

Turn off logging to DriverSet, Subscriber and Publisher logs

Turns all logging off for all the drivers 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.

23.4.2 Configuring Trace Level

You can configure trace for a specific driver set. Depending on the trace level specified for a driver set, 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 set, select IDM Administration > Click the context menu (three dots) of the appropriate Driver Set > Driver Set Properties > 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.

XSL trace level

Trace displays XSL events. Set this trace level only when troubleshooting XSL style sheets. If you do not want to see XSL information, set the level to zero.

Java debug port

Allows developers to attach a Java debugger. Restart the Identity Vault after attaching the Java debugger.

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 file encoding

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

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

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.

23.4.3 Tracing DirXML Script

The DirXML Script Tracing option allows you to select a trace level for a driver set. The selection gets applied to all the policies in the driver set. The following DirXML script tracing options are available to select:

  • All DirXML Script Tracing On

  • All DirXML Script Tracing Off

  • DirXML Script Rule Tracing On

  • DirXML Script Rule Tracing Off

Click to save your changes.

Figure 23-3 Managing Log and Trace Levels of Driver Sets