Tchater maintenant avec le support
Tchattez avec un ingénieur du support

Identity Manager 9.3 - 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

Displaying error messages in the One Identity Manager tools

The One Identity Manager tools offer various possible ways to display error messages.

Detailed information about this topic

The error message window in One Identity Manager tools

Error messages for the One Identity Manager tools are shown in a separate window. In addition, a more detailed description of the error is displayed.

Figure 2: Error message window

  • Configure the amount of information to be displayed using the options in the error message window.

    • Open the configuration view for the error messages window with the button and enable or disable the options you want.

    Table 8: Options for displaying error messages
    Option Meaning

    Show previous errors

    Specifies whether all previous errors that lead to the current error, should also be shown.

    Show One Identity error numbers

    Specifies whether internal error numbers are shown.

    Show error positions

    Specifies whether error position is also shown in the program code.

    Wrap long lines

    Specifies whether long error messages are wrapped.

    Show only user relevant

    Specifies whether all error messages are to be displayed or only those error messages that are classified as user relevant.

    Show asynchronous calls

    Specifies whether error messages in asynchronous method calls are shown.

  • To send the messages, click on the Send as mail button.

    This creates a new email message in the default mail program and copies over the error text.

  • To copy the messages to the clipboard, open the Send as mail menu and click Copy to clipboard.

  • Use screen capture to record the steps leading up to the error.

    To start the screen capture tool

    1. Open the Send as mail context menu and click Start screen capture.

    2. Confirm the security prompt with OK.

    3. Start capturing the screen with the Snipping Tool.

      For more information on screen capturing with the Snipping Tool, see the Microsoft documentation.

Displaying error log messages

A program's error log, as in the Manager for example, displays all the messages, such as error messages and warnings, that have occurred since the program started. The error log is reinitialized when the program is restarted.

NOTE: In the Manager, the icon in the program’s status bar indicates new messages in the error log. Double-click the icon to open the error log.

To display items from the Manager error log

  1. In the Manager, select the View > Error log menu item.

  2. Enable the view in the error log toolbar.

You can configure how the messages are displayed in the error log. To do this, switch the error log to advanced mode by clicking on the right of the column headers. Here you have the possibility to debug individual actions.

TIP: You can apply different filters to limit the information being displayed. Click the arrow in the column header and select a filter. The icon in the log toolbar shows whether a filter is active.

Figure 3: Simple error log (above) and advanced error log (below)

Table 9: Meaning of icons in the log
Icon Meaning

Logs all critical error messages. (Info level Fatal)

Logs all information. (Info level Info)

Logs all warnings. (Info level Warning)

Logs all error messages. (Info level Error)

Logs debugger output. This setting should only be used for testing. (Info level Debug)

Logs highly detailed information. This setting should only be used for analysis purposes. The log file quickly becomes large and cumbersome. (Info level Trace)

Adds a custom filter condition.

Deletes filter condition.

Searches for term.

Searches next term.

Marks all messages with a specific term.

Buffer size

Sets the message buffer size. The buffer's level is displayed next to the field.

Deletes the buffer contents.

Stops logging.

Starts logging.

Saves log to file.

Specifies which column are displayed in the error log.

Copies selected messages to the clipboard.

Opens the error log with a text editor.

The following information is displayed about a message. The range of information depends on the severity level of a message.

Table 10: Information about a message
Detail Description
Severity code Level of information supplied for the message.
Timestamp Time and date of the log entry.
Logger name One Identity Manager component from which the message was sent.
Message Logged message.
Error Message Detailed error message.
Data Additional data about the message.
Sequence ID Number of the line in the error log.
Stack trace Complete stack trace for the error message.
Session ID

Session identification number.

NOTE: If there is a filter set on the session ID, only the messages for this session are displayed, for example, loading collections and single objects. If the filter is not set, actions outside of the connection, such as loading of table definitions or configuration parameters, are also displayed.

TIP: Double-click a message to display detailed information.

Figure 4: Detailed information about a message

Related topics

Displaying system journal messages

The system journal is used to store information, warning, and error messages from different components of One Identity Manager, for example, DBQueue Processor, Configuration Wizard, or One Identity Manager Service. Actions in the Job Queue Info program, such as reactivating process steps, are also recorded in the system journal.

To display system journal entries in the Manager

  1. In the Manager, select the View > Error log menu item.

  2. Enable the view in the error log toolbar.

To display system journal entries in the Job Queue Info

  • In the Job Queue Info, select the View > System journal menu item.

TIP: You can apply different filters to limit the information being displayed. Click the arrow in the column header and select a filter. The icon in the log toolbar shows if a filter is active.

Table 11: Displaying messages in the system journal
Icon Meaning

Information is written to the error log/system journal.

A warning has been written to the system journal.

An error has been written to the system journal.

TIP: Double-click a message to display detailed information.

Figure 5: Detailed information about a message

The following information is displayed about a message. The range of information depends on the type of message.

Table 12: Information about a message
Detail Description

Message

Logged message.

Program

One Identity Manager component from which the message was sent.

Host

Computer from which the action was started.

Logged in system user

System user that triggered the action.

Type

Type of message. Following values are possible:

  • Warning: This is a warning (Warning info level).

  • Information: This is information (info info level).

  • Error: This is an error (Error info level).

  • Debug: This is a debug message (debug info level).

  • Trace: This is an output with more detailed information (Trace info level).

Date

Time and date of the log entry.

Related topics
Documents connexes

The document was helpful.

Sélectionner une évaluation

I easily found the information I needed.

Sélectionner une évaluation