WebSphere

This information applies to feature pack. To use what is described, you must have installed the optional feature pack Service monitoring properties

The following properties can be used to configure service monitoring. Use the administrative console to specify them as custom properties for the resource environment providers used for service monitoring. Changes to the values take effect after you save and synchronize your files.

The service monitor server gathers and aggregates response time and throughput measurements from all running service monitor agents, and then calculates and stores the statistics. The Service Monitor Graph widget queries the server for these measurements.

Use the following parameters to create or modify a configuration for the server. All parameters are used by the service monitor server; if you do not set them explicitly, the server uses the default value.
Table 1. Configuration parameters for the service monitor server
Parameter Description Default value
enable Enables or disables the service monitor server (com.ibm.bpm.servicemonitor.server).

If you need to disable the server for maintenance or other reasons, the server stops pulling measurements from the agents and serving data to clients.

False (disabled)

monitorTargets Lists the application clusters or standalone server you want to monitor. Use commas to separate targets (for example, clusters:OrderAppCluster, clusters:ShippingAppCluster).

If no explicit value is given, all servers in the specified scope are targeted for monitoring. Use this parameter to restrict the number of monitor targets.

No default value (all servers are monitor targets)
monitorDataSize Specifies, in megabytes (MB), the in-memory data store size for service monitoring measurements. When the data store reaches the specified size, the oldest entries are deleted and replaced with new data.

Set the value to 0 (zero) to prevent the server from storing measurements.

Note that 1 MB holds approximately 10 hours worth of continuous monitoring data for an operation.

5 MB
queryLimit Limits the maximum number of matched measurements returned by a Representational State Transfer (REST) query. It overrides any value set for the query itself.

Use a value of 0 (zero) to return all matched measurements.

10000
The service monitor agent monitors the response time and throughput on selected operations and sends the data to its service monitor server. Use the following parameters to create or modify a configuration for the service monitor agent. All parameters are used by the service monitor agent; if you do not set them explicitly, the agent uses the default value. Note that the agent is disabled by default.
Table 2. Configuration parameters for the service monitor agent
Parameter Description Default value
enable Enables or disables the service monitor agent (com.ibm.bpm.servicemonitor.agent).

If you need to disable the agent for maintenance or other reasons, the service monitor stops and the agent does not send data to the server.

False (disabled)

monitorOffSwitchTimeout

Specifies the time, in seconds, the monitor point remains active after receiving the last request. If no more requests are made, the monitor point switches off to preserve system performance. Set the value to zero (0) to disable the automatic switch off.

120 seconds
dataUpdateInterval Specifies the amount of time, in seconds, that can elapse between monitor data transmissions.
Reduce the interval if you have a high volume of monitor data and find you are missing measurements.
Note: Reducing the interval is not recommended if your system experiences heavy load.
5 seconds
dataBufferSize Specifies the monitor data buffer size, in kilobytes. The buffer stores the monitored Service Component Architecture (SCA) events before they are analyzed and sent to the service monitor server.

If your system experiences heavy load, consider increasing the buffer size. Note that if there is no memory available, data that exceeds the buffer is discarded.

Note that each kilobyte holds approximately 35 response time measurements.

512 KB

reference Reference topic

Terms of use | Feedback


Timestamp icon Last updated: 23 June 2009


http://publib.boulder.ibm.com/infocenter/dmndhelp/v6r2mx/topic/com.ibm.websphere.wbpm.fep.psesb.620.doc/doc/radm_sm_customprop.html
Copyright IBM Corporation 2005, 2009. All Rights Reserved.
This information center is powered by Eclipse technology (http://www.eclipse.org).