Chat now with support
Chat mit Support

Identity Manager 9.0 LTS - 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 One Identity Manager configuration files

Enabling and disabling extended logging of process steps

Success and error messages from process handling are written to the One Identity Manager Service log file. In order to test you processes, you can enable logging mode for process steps in the Job Queue Info. In this case, the processing messages of the processing step are written along with the Debug level of information into a separate log. You can display the log in the Job Queue Info as well as in the log file of the One Identity Manager Service itself.

NOTE: The log mode is only available if the logged in user has permissions for the Option to selectively set the logging mode of process steps in the Job queue in Job Queue Info program function (JobQueue_LogMode).

To enable process step logging mode

  • To log the messages on success and on failure, select the process step in the Job queue view in Job Queue Info and select the Processing log > Create always context menu.

  • To log the messages on failure only, in the Job Queue Info, select the process step in the Job queue view and select the Processing log > On Error context menu item.

NOTE: You can set the log mode by default for separate process steps. To do this, edit the process step in the Designer in Process Editor. For more information about editing processes and process steps, see the One Identity Manager Configuration Guide.

To display the log in Job Queue Info

  • In the Job queues view in Job Queue Info, select the process step and select the Processing log > Display context menu.

    This displays the log in a separate window. If a process step was run more than once, for example, if it is re-enabled more than once, several log are displayed.

To display the log in the One Identity Manager Service log file

  • In the Job Queue Info, select the Server status view on the Job server tab and select the Show in browser context menu item.

  • The log is marked with a link entry Log written to Job_<UID_Job>_<yyyymmdd>_<Timestamp>.log. Click the link to display the log.

    The files are stored in the One Identity Manager Service log directory.

    Repository structure:

    <Log directory>\JobLogs\<First 4 digits of the UID_Job>\Job_<UID_Job>_<yyyymmdd>_<Timestamp>.log

To end log mode

  • In Job Queue Info, in the Job queue view, select the process step and select the Processing log > Disable context menu item.

Related topics

Determining the status of the Job server and web server

To get a quick overview of the availability of the Job server and the web server, you can request the Job Queue Info's status.

NOTE: Set the HTTP port to be queried and the maximum response time for status queries in the program settings.

TIP: Use Refresh server list or F6 to reload the list of servers.

One Identity Manager Service configurations of each Job server stored in the database are used to get more detailed results of Job server status queries. This is especially required if the HTTP server port has been set individually or a Job server processes several queues. In the Designer, configure and enable the Get configuration file from the Job server and write in the Job server configuration schedule to import the One Identity Manager Service configuration of the Job server into the database. For more information, see the One Identity Manager Configuration Guide.

To query the status of all Job servers

  1. In the Job Queue Info program, select the View > Server state menu item.

  2. Select the Job server tab and press F5.

To query the status of a single Job server

  1. In the Job Queue Info program, select the View > Server state menu item.

  2. On the Job server tab, select the Job server and then the Get status context menu item.

NOTE: Use the Enter credentials context menu item to enter a user and password to request the server status. You can select more than one Job server. The user information is kept until the next time the Job Queue Info starts.

If the server responds, the system time, the One Identity Manager Service version and the One Identity Manager Service account name are determined and displayed. The software update status as well as the current version of the software are also displayed.

If an error occurs during the status request, the symbol is displayed for the Job server. You use the Show request error context menu item to show a detailed error message.

To display a Job server's services

  1. In the Job Queue Info program, select the View > Server state menu item.

  2. On the Job server tab, select the Job server and select the Show in browser context menu item.

    The One Identity Manager Service HTTP server for the Job server is queried and the varying One Identity Manager Service services are displayed.

To show the status of a web server

  1. In the Job Queue Info program, select the View > Server state menu item.

  2. On the Web server tab, select the web server and select the Show in browser context menu item.

Related topics

Configure process collection check for Job servers

On the Job server, the Last fetch time property logs when a process step was retrieved by the One Identity Manager Service. If no completion message for this process step has been returned within the time specified in the Common | Jobservice | LoadedJobsTimeOut configuration parameter, the One Identity Manager Service runs a check. The time of the last check for loaded process steps (Last timeout check property) is set to the current time.

To configure the process collection check, adjust the following settings in the Designer.

  • Common | Jobservice | LoadedJobsTimeOut configuration parameter

    The configuration parameter contains the time in minutes within which a process should be reported back before a check is run. Default value is 15 minutes.

    NOTE: If there are Job server that have exceeded the time limit, the Last timeout check column is displayed in red.

  • Common | MailNotification | NotifyAboutRequestStall configuration parameter

    Use the configuration parameter to specify whether an email notification should be sent when the One Identity Manager Service stops running requests. The configuration parameter is not set by default.

  • Send notification when Job server is not requesting processes schedule

    The schedule checks whether the One Identity Manager Service regularly asks for processes from a queue. If a One Identity Manager Service stops making process requests, notification is sent by email.

    Enable the schedule. The interval should be set as in the Common | Jobservice | LoadedJobsTimeOut configuration parameter.

Initializing One Identity Manager Service queues

A queue is initialized when the One Identity Manager Service starts. The One Identity Manager Service queries the Job queue to see which processes are waiting for its own queue. During the initialization phase, no processes are handled and it may take a long time, particularly if the Job queue is very full.

In Job Queue Info, in the Progress view, a warning shows you the queue being initialized. Click the message to get more detail.

Related topics
Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen