Monitoring the Verify Identity Governance Server

Edit online

Configure the Verify Identity Governance Server monitoring with IBM® Tivoli® Monitoring to collect performance metrics and service statistics from the IBM Verify Identity Governance over a time.

Before you begin

Make sure that IBM Tivoli Monitoring Version 6.2.3 is installed before you work with the Verify Identity Governance Server monitoring.

Make sure that the Universal Agent is installed with the product. It might be installed on a separate computer.

For more information, see Tivoli Monitoring documentation.

Procedure

  1. From the top-level menu of the Appliance Dashboard, select Monitor > Monitoring > Application.
  2. On the Identity Manager Server Monitoring page, do one of these actions.
    Configure the Verify Identity Governance Server monitoring
    1. Click Configure.
    2. On the Confirm action window, click Yes.
    3. On the Identity Manager server monitoring configuration window, provide these details.
      Identity Manager administrator ID
      The ID for the IBM Verify Identity Governance administrator. For example, itim manager.
      Identity Manager administrator password
      The password for the IBM Verify Identity Governance 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 the Verify Identity Governance Server. For example, 120 seconds.
      Monitoring metrics
      Select the items that you want to monitor for the Verify Identity Governance Server.
      Select all
      Select this option to monitor all the metrics for the Verify Identity Governance Server.
      Service summary
      Select this option to monitor the service summary. This metric contains cumulative information about all the IBM Verify Identity Governance 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 IBM Verify Identity Governance 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 the IBM Verify Identity Governance 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 the IBM Verify Identity Governance 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 Verify Identity Governance, 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® Liberty. To see these statistics, enable the Java virtual computer profiler data. For more information, see http://www.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.doc/info/ae/ae/tprf_jvmpidata.html.
    4. Click Save Configuration.
    5. Restart the cluster manager server if the Notifications widget indicates you to do it.

    A record is created for the Verify Identity Governance Server monitoring.

    Enable the Verify Identity Governance Server monitoring
    1. Select the record that you configured for the Verify Identity Governance Server monitoring.
    2. Click Enable.
    3. On the Confirm action window, click Yes.
    4. Restart the cluster manager server if the Notifications widget indicates you to do it.
    Disable the Verify Identity Governance Server monitoring
    1. Select the record that you configured for the Verify Identity Governance Server monitoring.
    2. Click Disable.
    3. Restart the cluster manager server if the Notifications widget indicates you to do it.
    Reconfigure the Verify Identity Governance Server monitoring
    1. Click Reconfigure.
    2. On the Edit Identity Manager server monitoring configuration window, provide these details.
      Identity Manager administrator ID
      The ID for the IBM Verify Identity Governance administrator. For example, itim manager.
      Identity Manager administrator password
      The password for the IBM Verify Identity Governance 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 the Verify Identity Governance Server. For example, 180 seconds.
      Monitoring metrics
      Select the items that you want to monitor for the Verify Identity Governance Server.
      Select all
      Select this option to monitor all the metrics for the Verify Identity Governance Server.
      Service summary
      Select this option to monitor the service summary. This metric contains cumulative information about all the IBM Verify Identity Governance 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 IBM Verify Identity Governance 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 the IBM Verify Identity Governance 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 the IBM Verify Identity Governance 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 Verify Identity Governance, 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 Liberty. To see these statistics, enable the Java virtual computer profiler data. For more information, see http://www.ibm.com/support/knowledgecenter/SSAW57_7.0.0/com.ibm.websphere.nd.doc/info/ae/ae/tprf_jvmpidata.html.
    3. Click Save Configuration.
    Export the Verify Identity Governance Server monitoring
    1. Select the record that you configured for the Verify Identity Governance Server monitoring.
    2. Click Export to save the file on your local computer.
    3. 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.
    4. Transfer this file to the computer where IBM Tivoli Monitoring is running.
    5. On the IBM Tivoli Monitoring computer, copy the isim.mdl file into the directory that contains the Universal Agent meta files. For example: C:\IBM\ITM\TMAITM6\metafiles.
    6. Ensure that the IBM Tivoli Monitoring Server and the IBM Tivoli Monitoring Universal Agent are running.
    7. Import the metafile by using one of the following examples:
      • Example 1: Open a command editor. Type the C:\IBM\ITM\bin\um_console -h ITM_HOME command to go to the Universal Agent prompt. Type the import C:\IBM\ITM\TMAITM6\metafiles\isim.mdl command.
      • Example 2: Open a command editor. Type command C:\IBM\ITM\TMAITM6> kumpcon import isim.mdl