Action monitor

This topic introduces the PPM action monitor and how you can use the action monitor to track activities in the standard interface.

Overview of action monitor

The PPM action monitor tracks activity in the standard interface.

You use the following parameters to control the monitor:

  • ENABLE_UI_MONITOR. Turns the monitor on (the default).
  • UI_MONITOR_THRESHOLD. Controls the threshold value of the action monitor (in milliseconds).

Back to top

Change action monitor parameters

You can change the values of the ENABLE_UI_MONITOR and UI_MONITOR_THRESHOLD parameters through the JMX console without the need to stop, and start the PPM Server. Keep in mind that if you change these parameter settings through the JMX console, your changes do not persist. The next time you start the PPM Server, the parameter settings revert to the values specified for them in the server.conf file.

To enable or disable the UI monitor through the Administration Console:

  1. Log on to PPM.

  2. From the menu bar, select Open > Administration > Open Administration Console.

  3. From the Administration Console navigation bar, select Administration Task > Application configuration.

  4. On the Application Configuration page, select the desired PPM Server node from the Scope drop-down list, and search for the ENABLE_UI_MONITOR parameter.

  5. Set ENABLE_UI_MONITOR parameter to true enable the UI monitor, or to false to disable the UI monitor.

To change the UI_MONITOR_THRESHOLD parameter value:

  1. Log on to PPM.

  2. From the menu bar, select Open > Administration > Open Administration Console.

  3. Go to the Application Configuration page, select the desired PPM Server node from the Scope drop-down list, and search for UI_MONITOR_THRESHOLD parameter.

  4. Specify a value for the UI_MONITOR_THRESHOLD parameter.

Back to top

View action monitor information in real time

To see the information captured by the action monitor in real time:

  1. Go to the JMX console.

  2. Access the ActionMonitor MBean in the ppm.monitor section.

    The ten UI activities (URL requests) that most affect performance are listed, as well as their average, minimum, and maximum execution times.

Back to top

Action monitor information log

If the latency for serving the URL request exceeds the threshold value, the captured information is saved to the thresholdLog.txt file located in the <PPM_Home>/server/<PPM Server>/logs directory.

The information is formatted as follows:

["UI",<User_Name>,"<Requested_URL>","<Execution_Time>(ms)"]

The information resembles the following:

ActionMonitorLogger:2009/01/11-23:26:-6.179 PST: "UI",admin,"http://37.30.24.33:8080/itg/web/knta/global/AutoCompPopup.jsp","78(ms)" ;
    Note:
  • You can also use the 'UI_MONITOR_PERSIST_STATE' parameter in the Administration Console to enable or disable persisting the captured information to the database table PPM_PERFORMANCE_LOG.
  • For information on how to create a report on action monitor activity, see Deployment Best Practices for PPM Operational Reporting.

Back to top

SQLs in PPM_PERFORMANCE_LOG for action monitor

When the ENABLE_ALL_PERFORMANCE_MONITOR parameter is set to true, and if the latency of serving a URL request exceeds the threshold value specified in the UI_MONITOR_THRESHOLD parameter, then the SQLs that have been executed when serving the URL request are recorded in the PPM_PERFORMANCE_LOG table.

Note: Only the top five SQLs that take the longest time when serving the URL request are recorded.

Back to top