About this guide
The One Identity Manager Process Monitoring and Troubleshooting Guide describes the various methods of monitoring process handling and of localizing errors in One Identity Manager. It also explains advanced log configuration in One Identity Manager.
It is assumed that you understand the concept and the architecture of One Identity Manager. It is also assumed that you are thoroughly familiar with the One Identity Manager tools.
You can find additional notes about error localization and troubleshooting in the other One Identity Manager guides.
Available documentation
You can access One Identity Manager documentation in the Manager and in the Designer by selecting the Help > Search menu item. The online version of One Identity Manager documentation is available in the Support portal under Technical Documentation. You will find videos with additional information at www.YouTube.com/OneIdentity.
Detailed information about this topic
Monitoring handling of processes
The Job Queue Info program helps you check the current status of the services running in the One Identity Manager network. It enables a detailed and comprehensive overview of the requests in the Job queue and various One Identity Manager Service requests on the servers. This program makes it easier to work with processes, supplies status information during run-time and allows errors to be quickly recognized and debugged.
In the Job Queue Info program, you can:
-
Monitor handling of Job queue processes.
-
Monitor processing of the DBQueue.
-
Monitor the status of the Job server and web server.
-
Display the One Identity Manager Service log file.
-
Display the system journal.
Detailed information about this topic
Working with the Job Queue Info program
The Job Queue Info program has several views for the layout of processes and process steps in the Job queue.
Some of the functions in Job Queue Info, for example certain menu items or key combinations, can only be used if the current user has the corresponding program functionality. For more information about controlling permissions with program functions, see the One Identity Manager Authorization and Authentication Guide.
Views in the Job Queue Info
The Job Queue Info has several views for displaying and editing processes and process steps in the Job queue.
Table 1: Job Queue Info views
Job queue |
This view shows the contents of the Job queue grouped by processes. In the first level of the hierarchy, all the processes are shown with a process count. If a process node is opened, all the processes are shown with start times. The complete process with its hierarchy is displayed under a process node. Each process step contains its success and failure branches as sub elements. |
Job server |
This view shows the Job queue contents sorted by executing servers. At the first hierarchy level, all Job servers are displayed, with their counts of the different processes, that exist in the Job queue for the Job server. If a Job server node is opened, the process tasks are listed and the number of process step per process task is shown. The process steps are listed by start time under the process task node. |
Process History |
The view show processes that are already finished. The flow of process handling is displayed in the order of the processes. You can limit the list of processes in the process history to only processes with errors in the program settings. If you select a failed process step, the entire error message is shown in a tooltip. |
Base objects |
The process history entries and the current Job queue entries are summarized here in this view for the object being processed. If an error occurs during processing and the process handling is stopped (Frozen or Overlimit status), you can analyze the previous processing sequence in this view. Once all processes have been successfully handled for this object the error messages are removed from the view. |
Process |
This view gives an overview of how process steps are linked within a process. In this way, the handling sequence of individual process steps for large processes can be monitored better. After selecting a process, all its process steps are displayed. |
Process step |
In this view detailed information is displayed for each process step. The view shows the data structure for a process step at compilation time. After selecting a process step, specific information from the Job queue is mapped as well as each parameter of the selected process step with its values. |
Parameters |
After selecting a process step, the passing parameters of the process step are displayed with their names and their values. If the selected node does not represent a process step, the parameter view is cleared. |
Affected objects |
This view shows all objects that are affected by a process step. |
Progress |
This view displays the number of entries in the Job queue is queried. The current value is represented by a number and inserted, at the same time, into a bar graph. The process step progress state is shown in different colors. |
Server state |
This view gives you a faster overview of all the Job servers and Web servers available in the network. |
DBQueue |
Calculation tasks in the DBQueue used for DBQueue Processor processing are displayed in this view. The number, sort order and name of the queued requests are displayed. |
System journal |
Displays entries in the system journal. |