Chat now with support
Chat with Support

Identity Manager 9.2.1 - Process Monitoring and Troubleshooting Guide

About this guide Monitoring handling of processes Support for error localization in One Identity Manager Configuring logs in One Identity Manager Application-specific configuration files

Advanced logging in the One Identity Manager Service

To use advanced logging for the One Identity Manager Service, configure the storage of log files in the One Identity Manager Service configuration file in the Connection module.

NOTE: The given directories must exist and the One Identity Manager Service user account must have write permissions to the directory.

Following parameters are available:

  • Process generation log directory (JobGenLogDir)

    Log files are created in the specified directory to log the process generation instructions generated by One Identity Manager Service.

For more information about configuring the One Identity Manager Service, see the One Identity Manager Configuration Guide.

Extended debugging in One Identity Manager Service

The Configuration module of the One Identity Manager Service configuration file provides two parameters for advanced debugging:

  • DebugMode

  • ComponentDebugMode

If the Debug mode (DebugMode) parameter is enabled, the One Identity Manager Service writes more extensive information into the log file, such as all parameters transferred to a component and the results of the process handling and their Out parameters.

Individual One Identity Manager Service process components can output additional process data to the One Identity Manager Service log file. For this purpose, you can enable the Component debug mode (ComponentDebugMode) parameter in the configuration module. Use this debug mode only for localizing errors because the effect on performance means that it is not recommended for normal use.

For more information about configuring the One Identity Manager Service, see the One Identity Manager Configuration Guide.

Outputting custom messages in the One Identity Manager Service log file

IMPORTANT: You should never use the VB.NET functions Msgbox and Inputbox on servers. Use the functions VID_Write2Log, RaiseMessage or AppData.Instance.RaiseMessage.

You can use the RaiseMessage and AppData.Instance.RaiseMessage script engine tasks from within process steps to write custom messages to the One Identity Manager Service log file. Use the ScriptComponent process component to run the scripts.

The messages in the log file are marked in color depending on the specified severity (MsgSeverity parameter).

Figure 8: Example output of custom messages to the One Identity Manager Service log file

RaiseMessage

The output is consolidated with other messages and logged at the end of processing the process step.

Syntax:

RaiseMessage (MsgSeverity, "string")

Example:

RaiseMessage (MsgSeverity.Warning, "Example warning message")

RaiseMessage (MsgSeverity.Info, "Example Info message")

RaiseMessage (MsgSeverity.Serious, "Example error marked message")

AppData.Instance.RaiseMessage

The output is issued immediately during processing regardless of whether processing of the process step has ended.

Syntax:

AppData.Instance.RaiseMessage (MsgSeverity, "string")

Example:

AppData.Instance.RaiseMessage (MsgSeverity.Warning, "Example warning message")

AppData.Instance.RaiseMessage (MsgSeverity.Info, "Example Info message")

AppData.Instance.RaiseMessage (MsgSeverity.Serious, "Example error marked message")

For more examples of One Identity Manager Service log file output, see the script example on the installation medium in the directory QBM\dvd\AddOn\SDK\ScriptSamples.

Logging One Identity Manager Service messages in the event view

To log One Identity Manager Service messages in the server's event log, modify the EventLogLogWriter module in the One Identity Manager Service's configuration file. To view the event log, you can use the results display in the Microsoft Management Console, for example.

Table 19: EventLogLogWriter parameters

Parameters

Description

EventLog

Name of the event log to which the messages are written. The messages are written to the application log with Application as the default value.

NOTE: If more than one One Identity Manager Service write event logs on a server, make sure that the first eight letters in the log name are unique on the server.

LogSeverity

Severity levels of the logged messages.

Permitted values are:

  • Info: All messages are written to the event log. The event log quickly becomes large and confusing.

  • Warning: Only warnings and exception errors are written to the event log (default).

  • Serious: Only exception messages are written to the event log.

EventID

The ID of the messages written to the event log.

Category

The category of the messages written to the event log.

Source

The name of the source of the messages written to the event log.

Process handling errors can also be written to a server’s result log. To do this, use the LogComponent process component.

For more information about configuring the One Identity Manager Service, see the One Identity Manager Configuration Guide.

Related topics
Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating