Monitoring ISIM Server

Monitoring ISIM Server

Configure ISIM Server monitoring with IBM Tivoli Monitoring to collect performance metrics and service statistics from ISIM over a time.

Make sure that IBM Tivoli Monitoring Version 6.2.3 is installed before working with ISIM Server monitoring.
Make sure that the Universal Agent is installed with the product. It might be installed on a separate computer.
See http://www.ibm.com/support/knowledgecenter/SSTFXA_6.2.3.1/com.ibm.itm.doc_6.2.3fp1/itm623FP1_install118.htm%23installation.

From the top-level menu of the Appliance Dashboard, select Monitor > Monitoring > Application.
On ISIM Server Monitoring page, do one of these actions.

Configure ISIM Server monitoring

Click Configure.
On the Confirm action window, click Yes.
On ISIM server monitoring configuration window, provide these details.

Identity Manager administrator ID

The ID for the ISIM administrator. For example, itim manager.

Identity Manager administrator password

The password for the ISIM administrator. For example, secret.

Universal Agent host name

The host name of the Universal Agent. For example, specify isimhost.mycompany.com.

Universal Agent port

The port of the Universal Agent. For example, 7500.

Monitoring interval

The time interval between 2 performance updates of ISIM Server. For example, 120 seconds.

Monitoring metrics

Select the items that to monitor for ISIM Server.

Select all

Select this option to monitor all the metrics for ISIM Server.

Service summary

Select this option to monitor the service summary. This metric contains cumulative information about all ISIM services. It includes statistics such as the number of services that failed and recovered. It also contains useful information such as the number of active processed requests, and number of threads that did not process.

Service details

Select this option to monitor the service details. This metric contains information about individual ISIM services. It includes similar information as the service summary for each individual service instance.

Service failures

Select this option to monitor the service failures. This metric contains information about individual services that did not succeed. It includes this information:

The service name that did not succeed.
The number of requests that are blocked.
The date and time the service first did not succeed.
The error message that describes the failure.

Workflow requests

Select this option to monitor workflow requests. This metric contains information about requests that are processed by ISIM workflow. It contains statistics such as the number of processes that started and finished.

JMS queues

Select this option to monitor the JMS queues. This metric contains the sizes of ISIM JMS queues. These queues are an indication of the current workload.

Process statistics

Select this option to monitor the process statistics. This metric contains statistics about the Java™ process that runs IBM Security Identity Manager, such as CPU usage, memory consumption, thread count, and garbage collection. The thread count and garbage collection statistics are not enabled by default in WebSphere Application Server. To see these statistics, enable the Java virtual computer profiler data. See http://www.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.doc/info/ae/ae/tprf_jvmpidata.html.

Click Save Configuration.
Restart the cluster manager server if the Notifications widget indicates you to do it.

A record is created for ISIM Server monitoring.

Enable ISIM Server monitoring

Select the record that you configured for ISIM Server monitoring.
Click Enable.
On the Confirm action window, click Yes.
Restart the cluster manager server if the Notifications widget indicates you to do it.

Disable ISIM Server monitoring

Select the record that you configured for ISIM Server monitoring.
Click Disable.
Restart the cluster manager server if the Notifications widget indicates you to do it.

Reconfigure ISIM Server monitoring

Click Reconfigure.
On the Edit ISIM server monitoring configuration window, provide these details.

Identity Manager administrator ID

The ID for the ISIM administrator. For example, itim manager.

Identity Manager administrator password

The password for the ISIM administrator. For example, secret.

Universal Agent host name

The host name of the Universal Agent. For example, specify isimhost1.mycompany.com.

Universal Agent port

The port of the Universal Agent. For example, 7500.

Monitoring interval

The time interval between 2 performance updates of ISIM Server. For example, 180 seconds.

Monitoring metrics

Select the items that to monitor for ISIM Server.

Select all

Select this option to monitor all the metrics for ISIM Server.

Service summary

Select this option to monitor the service summary. This metric contains cumulative information about all ISIM services. It includes statistics such as the number of services that failed and recovered. It also contains useful information such as the number of active processed requests, and number of threads that did not process.

Service details

Select this option to monitor the service details. This metric contains information about individual ISIM services. It includes similar information as the service summary for each individual service instance.

Service failures

Select this option to monitor the service failures. This metric contains information about individual services that did not succeed. It includes this information:

The service name that did not succeed.
The number of requests that are blocked.
The date and time the service first did not succeed.
The error message that describes the failure.

Workflow requests

Select this option to monitor workflow requests. This metric contains information about requests that are processed by ISIM workflow. It contains statistics such as the number of processes that started and finished.

JMS queues

Select this option to monitor the JMS queues. This metric contains the sizes of ISIM JMS queues. These queues are an indication of the current workload.

Process statistics

Select this option to monitor the process statistics. This metric contains statistics about the Java process that runs IBM Security Identity Manager, such as CPU usage, memory consumption, thread count, and garbage collection. The thread count and garbage collection statistics are not enabled by default in WebSphere Application Server. To see these statistics, enable the Java virtual computer profiler data. See http://www.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.doc/info/ae/ae/tprf_jvmpidata.html.

Click Save Configuration.

Export ISIM Server monitoring

Select the record that you configured for ISIM Server monitoring.
Click Export to save the file on your local computer.
Import the isim.mdl file into IBM Tivoli Monitoring Universal Agent to define the syntax of the metrics that the monitor sends to the Universal Agent.
Transfer this file to the computer where IBM Tivoli Monitoring is running.
On the IBM Tivoli Monitoring computer, copy the isim.mdl file into the directory containing the Universal Agent meta files. For example: C:\IBM\ITM\TMAITM6\metafiles.
Ensure that the IBM Tivoli Monitoring Server and the IBM Tivoli Monitoring Universal Agent are running.
Import the metafile by using one of the following examples:

Example 1:

Open a command editor.
Enter the C:\IBM\ITM\bin\um_console -h ITM_HOME command to go to the Universal Agent prompt.
Enter the import C:\IBM\ITM\TMAITM6\metafiles\isim.mdl command.

Example 2:

Open a command editor.
Enter the C:\IBM\ITM\TMAITM6> kumpcon import isim.mdl command.

Parent topic: Manage system settings for the virtual appliance

Configure ISIM Server monitoring	Click Configure. On the Confirm action window, click Yes. On ISIM server monitoring configuration window, provide these details. Identity Manager administrator ID The ID for the ISIM administrator. For example, itim manager. Identity Manager administrator password The password for the ISIM administrator. For example, secret. Universal Agent host name The host name of the Universal Agent. For example, specify isimhost.mycompany.com. Universal Agent port The port of the Universal Agent. For example, 7500. Monitoring interval The time interval between 2 performance updates of ISIM Server. For example, 120 seconds. Monitoring metrics Select the items that to monitor for ISIM Server. Select all Select this option to monitor all the metrics for ISIM Server. Service summary Select this option to monitor the service summary. This metric contains cumulative information about all ISIM services. It includes statistics such as the number of services that failed and recovered. It also contains useful information such as the number of active processed requests, and number of threads that did not process. Service details Select this option to monitor the service details. This metric contains information about individual ISIM services. It includes similar information as the service summary for each individual service instance. Service failures Select this option to monitor the service failures. This metric contains information about individual services that did not succeed. It includes this information: The service name that did not succeed. The number of requests that are blocked. The date and time the service first did not succeed. The error message that describes the failure. Workflow requests Select this option to monitor workflow requests. This metric contains information about requests that are processed by ISIM workflow. It contains statistics such as the number of processes that started and finished. JMS queues Select this option to monitor the JMS queues. This metric contains the sizes of ISIM JMS queues. These queues are an indication of the current workload. Process statistics Select this option to monitor the process statistics. This metric contains statistics about the Java™ process that runs IBM Security Identity Manager, such as CPU usage, memory consumption, thread count, and garbage collection. The thread count and garbage collection statistics are not enabled by default in WebSphere Application Server. To see these statistics, enable the Java virtual computer profiler data. See http://www.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.doc/info/ae/ae/tprf_jvmpidata.html. Click Save Configuration. Restart the cluster manager server if the Notifications widget indicates you to do it. A record is created for ISIM Server monitoring.
Enable ISIM Server monitoring	Select the record that you configured for ISIM Server monitoring. Click Enable. On the Confirm action window, click Yes. Restart the cluster manager server if the Notifications widget indicates you to do it.
Disable ISIM Server monitoring	Select the record that you configured for ISIM Server monitoring. Click Disable. Restart the cluster manager server if the Notifications widget indicates you to do it.
Reconfigure ISIM Server monitoring	Click Reconfigure. On the Edit ISIM server monitoring configuration window, provide these details. Identity Manager administrator ID The ID for the ISIM administrator. For example, itim manager. Identity Manager administrator password The password for the ISIM administrator. For example, secret. Universal Agent host name The host name of the Universal Agent. For example, specify isimhost1.mycompany.com. Universal Agent port The port of the Universal Agent. For example, 7500. Monitoring interval The time interval between 2 performance updates of ISIM Server. For example, 180 seconds. Monitoring metrics Select the items that to monitor for ISIM Server. Select all Select this option to monitor all the metrics for ISIM Server. Service summary Select this option to monitor the service summary. This metric contains cumulative information about all ISIM services. It includes statistics such as the number of services that failed and recovered. It also contains useful information such as the number of active processed requests, and number of threads that did not process. Service details Select this option to monitor the service details. This metric contains information about individual ISIM services. It includes similar information as the service summary for each individual service instance. Service failures Select this option to monitor the service failures. This metric contains information about individual services that did not succeed. It includes this information: The service name that did not succeed. The number of requests that are blocked. The date and time the service first did not succeed. The error message that describes the failure. Workflow requests Select this option to monitor workflow requests. This metric contains information about requests that are processed by ISIM workflow. It contains statistics such as the number of processes that started and finished. JMS queues Select this option to monitor the JMS queues. This metric contains the sizes of ISIM JMS queues. These queues are an indication of the current workload. Process statistics Select this option to monitor the process statistics. This metric contains statistics about the Java process that runs IBM Security Identity Manager, such as CPU usage, memory consumption, thread count, and garbage collection. The thread count and garbage collection statistics are not enabled by default in WebSphere Application Server. To see these statistics, enable the Java virtual computer profiler data. See http://www.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.doc/info/ae/ae/tprf_jvmpidata.html. Click Save Configuration.
Export ISIM Server monitoring	Select the record that you configured for ISIM Server monitoring. Click Export to save the file on your local computer. Import the isim.mdl file into IBM Tivoli Monitoring Universal Agent to define the syntax of the metrics that the monitor sends to the Universal Agent. Transfer this file to the computer where IBM Tivoli Monitoring is running. On the IBM Tivoli Monitoring computer, copy the isim.mdl file into the directory containing the Universal Agent meta files. For example: C:\IBM\ITM\TMAITM6\metafiles. Ensure that the IBM Tivoli Monitoring Server and the IBM Tivoli Monitoring Universal Agent are running. Import the metafile by using one of the following examples: Example 1: Open a command editor. Enter the C:\IBM\ITM\bin\um_console -h ITM_HOME command to go to the Universal Agent prompt. Enter the import C:\IBM\ITM\TMAITM6\metafiles\isim.mdl command. Example 2: Open a command editor. Enter the C:\IBM\ITM\TMAITM6> kumpcon import isim.mdl command.