Smarter Server - Request Monitor

Authors: JorgeAlbertoDiaz
Build basis: Collaborative Lifecycle Management 4.0.4

The Request Monitor is responsible for gathering performance information of the server side requests processing and response times; and monitoring whether a particular request exceeds the defined threshold.

JMX Interface Name: com.ibm.team.server.monitoring.management.request.RequestMonitorRollupMBean
JMX Object Name: team.server.<application public URI context>@<port>:type=Request
JMX Object Name Example: team.server./jts@9443:type=Request

A JMX object of this "type" will be created for each monitored request identified by its URI:

• Request Monitor JMX Object Name: team.server.<application public URI context>@<port>:type=Request
  
• Request JMX Object Name: team.server.<application public URI context>@<port>:type=Request,name="<requestURI>"
  

The Request Monitor performance metrics information are rolled up from the performance information from all the individual monitored requests. Visually, the Request Monitor objects structure is like the following:

   team.server./<URL>@<port>:type=Request
          |
          |
          |---- team.server./<URL>@<port>:type=Request,name="<requestURI>"
          |---- team.server./<URL>@<port>:type=Request,name="<request2URI2>"
                                ...    
   

Monitor Attributes

Following are the attributes exposed by the Request Monitor

JMX Attribute	JMX Type	Is Writeable?	Default Value	Description
AverageResponseTime	long	No	0	Average response time from all the monitored requests
AverageRequestSize	long	No	0	Average size of all monitored requests
Count	long	No	0	Counter of all monitored operations
Threshold	java.lang.Long	Yes	10000	Defines the maximum allowed time for a request to be processed. If this time is exceeded a problem will be generated
MaximumResponseTime	long	No	0	Maximum response time of a request from all the monitored requests
MaximumRequestSize	long	No	0	Maximum size of a request from all the monitored requests
MinimumResponseTime	long	No	0	Minimum response time of a request from all the monitored requests
MinimumRequestSize	long	No	0	Minimum size of a request from all the monitored requests
Duration	long	No	0	Total duration of monitored requests processing
TimeSinceLastReset	long	No	0	Total time since the last statistics reset
Enabled	boolean	Yes	false	Whether this monitor is enabled. Default is disabled so no performance monitoring of requests is performed

Note the attributes related with time statistics are expressed in miliseconds

Monitor Operations

JMX Operation Signature	Return Type	Description
dismissAllProblems()	void	When called, all the problems tracked by this monitor are dismissed
reset()	void	When called, resets the statistics of the monitor

Child MBeans

This section gathers information regarding MBeans that are contained within this monitor

Request objects

An instance of a monitored request. A request is uniquely identified by its request URI path; subsequent calls to the same URI will be monitored by the same JMX object contributing performance information metrics. When the request monitor determines that a request has finished it will record the duration and rollup metrics.

JMX Interface Name: com.ibm.team.server.monitoring.jmx.beans.RequestMBean
JMX Object Name: team.server.<application public URI context>@<port>:type=Request,name="<>"
JMX Object Name Example: team.server./jts@9443:type=Request,name="/contributorRecords/"

Attributes

JMX Attribute	JMX Type	Is Writeable?	Default Value	Description
AverageRequestSize	long	No	0	Average size of the requests
AverageResponseTime	long	No	0	Average response time of the requests
Count	long	No	0	Counter of all monitored operations
Duration	long	No	0	Total duration processing duration of the requests
MaximumRequestSize	long	No	0	Maximum size of the requests
MaximumResponseTime	long	No	0	Maximum response time of the requests
MinimumRequestSize	long	No	0	Minimum size of the requests
MinimumResponseTime	long	No	0	Minimum response time of the requests
TimeSinceLastReset	long	No	0	Total time since the last statistics reset

Note the attributes related with time statistics are expressed in miliseconds

Operations

JMX Operation Signature	Return Type	Description
reset()	void	When called, resets the statistics of this monitored request

---

External links:

• IBM

Additional contributors: TWikiUser, TWikiUser