IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
ITCAM for Application Diagnostics - XD Agent situations
WebSphere XD has a number of predefined situations that you can use to complete the following tasks:
- Detect importance conditions in the WebSphere XD cell you monitor.
- Create your own situations using the predefined situations as examples.
These predefined situations display an alert status. When these situations trigger an alert, you can investigate the event by opening its workspace. For example, you can use these situations to monitor a WebSphere XD cell for requests not meeting the expected goal.
How the situations work
Situations are tests expressed in IF-TRUE format of system conditions to monitor; the tested value is an ITCAM Agent for WebSphere Applications attribute expressed in the form attribute-group.attribute-name. If the specified condition occurs or exists, the situation is true, and an alert is issued.
Avoid using negative values
If you define situations that use a counter or a range of numbers, always provide a threshold or use values in a positive range of numbers. For example, use a greater-than-or-equal-to-zero expression as shown in some of the following predefined situations. This practice prevents a situation from falsely tripping. If the ITCAM Agent for WebSphere Applications Tivoli Enterprise Management Agent encounters an undefined attribute value, it reports this value as a negative number and a situation that specifies a negative number can fire erroneously.
Access the situations
A number of predefined situations are shipped to monitor the WebSphere XD Cell. All of the situations except XDVEAppReqArrivedRateHigh are active by default. You can customize thresholds used in a situation to suit your environment. Situation XDVEAppReqArrivedRateHigh, needs to be run manually. To start a situation manually, access the situations in the Tivoli Enterprise Portal using one of the following methods:
- From the toolbar on the main menu click the Situation Editor icon and scroll to the situation you want to view.
- In the WebSphere agent, right click the specific workspace. Click Manage Situations to display all the managed situations available. To start, stop edit or model a situation right click the situation and select the option you want.
XDConnectionError
Monitor connectivity between the monitoring agent and the deployment manager. If there is no connection between the monitoring agent and the deployment manager, issue a Critical alert. The formula is:
If
WebSphereXD_Cell.Connection_Status equals error
then
the situation XDConnectionError is true.
XDCPUUsedHigh
Monitor the percentage of the CPU being consumed. Issue a Critical alert when the CPU usage is higher than 80%. The formula is:
If
WebSphereXD_Servers.CPU_Used_Percent is greater than 80
then
the situation XDCPUUsedHigh is true.
XDVEODRNotRunning
Monitor the ODR servers running in the XD cell. Issue a Critical alert when the number of ODR servers running equals 0. The formula is:
If
WebSphere_XD_ODR.Servers_Running equals 0 and WebSphere_XD_ODR.Row_Type equals ODR
then
the situation XDVEODRNotRunning is true.
XDVEODRQueueLengthHigh
Monitor the average ODR server queue length. Issue a Critical alert when the queue length is longer than 10. The formula is:
If
WebSphere_XD_ODR.Average_Queue_Length is greater than 10 and WebSphere_XD_ODR.Row_Type equals ODR
then
the situation XDVEODRQueueLengthHigh is true.
XDVEAppReqFailedPercentHigh
Monitor the percentage of failed application requests. Issue a Critical alert when an application request fails. The formula is:
If
WebSphere_XD_ODR.Request_Failed_Percent is greater than 0 and WebSphere_XD_ODR.Row_Type equals Application
then
the situation XDVEAppReqFailedPercentHigh is true.
XDVEAppReqDroppedPercentHigh
Monitor the percentage of application requests that drop. Issue a Critical alert when an application request drops. The formula is:
If
WebSphere_XD_ODR.Request_Dropped_Percent is greater than 0 and WebSphere_XD_ODR.Row_Type equals Application
then
the situation XDVEAppReqDroppedPercentHigh is true.
XDVEAppReqArrivedRateHigh
Monitor the application request arrival rate. Issue a Critical alert when the request arrival rate is higher than 1000 per second. The formula is:
If
WebSphere_XD_ODR.Request_Arrived_Rate is greater than 1000 and WebSphere_XD_ODR.Row_Type equals Application
then
the situation XDVEAppReqArrivedRateHigh is true.You will need to run this situation XDVEAppReqArrivedRateHigh manually.
XDVEAppReqAboveGoalPercentHigh
Monitor the number of application requests above the response time threshold during the sampling interval. Issue a Critical alert when the average request response time is 0 percent. The formula is:
If
WebSphere_XD_ODR.Requests_Above_Goal_Percent is greater than 0 and WebSphere_XD_ODR.Row_Type equals Application
then
the situation XDVEAppReqAboveGoalPercentHigh is true.
XDVEAppReqTimedOutPercentHigh
Monitor the percentage of application requests that time out. Issue a Critical alert when an application request times out. The formula is:
If
WebSphere_XD_ODR.Request_Timed_Out_Percent is greater than 0 and WebSphere_XD_ODR.Row_Type equals Application
then
the situation XDVEAppReqTimedOutPercentHigh is true.
XDVEServerMaintenance
Monitor the need for server maintenance. Issue a Critical alert when a server requires maintenance. The formula is:
If
WebSphere_XD_ODR.Server_State equals Maintenance and WebSphere_XD_ODR.Row_Type equals Server
then
the situation XDVEServerMaintenance is true.
XDVEDynClusterPartlyRunning
Monitor for any dynamic clusters that are partially running. Issue a Critical alert when this is the case. The formula is:
If
WebSphereXD_Dynamic_Clusters.Cluster_State equals Partially_Running
then
the situation WASPortletResponseTime is true.
XDVESPolicyTaskOpen
Search for open service policy violation tasks. Issue a Critical alert when one occurs. The formula is:
If
WebSphereXD_Policy_Violations.Service_Policy is not equal to "empty string"
then
the situation XDVESPolicyTaskOpen is true.
XDCGJobSchNotRunning
Monitor the connectivity of the Job Scheduler servers. Issue a Critical alert when a Job Scheduler server is not running. The formula is:
If
WebSphereXD_Compute_Grid.Job_Scheduler_Servers_Running equals Cell and WebSphere_XD_Compute_Grid.Row_Type equals Cell
then
the situation XDCGJobSchNotRunning is true.
XDCGJobSchQueueLengthHigh
Monitor the Job Scheduler queue length. Issue a Critical alert when the queue length is higher than 5000 per second. The formula is:
If
WebSphereXD_Compute_Grid.Jobs_in_Queue is greater than 5000 and WebSphere_XD_Compute_Grid.Row_Type equals Job_Scheduler_Server
then
the situation XDCGJobSchQueueLengthHigh is true.
XDCGJobSchDispErrorPercentHigh
Monitor the percentage of job scheduler jobs that fail. Issue a Critical alert when a job fails. The formula is:
If
WebSphereXD_Compute_Grid.Average_Job_Dispatch_Error_Time is greater than 0 and WebSphere_XD_Compute_Grid.Row_Type equals Job_Scheduler_Server
then
the situation XDCGJobSchDispErrorPercentHigh is true.
XDCGJobExcessiveExecTotalTime
Monitor the duration time of a job. Issue a Critical alert when the job execution time is longer than one day (1440 mins). The formula is:
If
WebSphereXD_Jobs.Total_Time is greater than 1440
then
the situation XDCGJobExcessiveExecTotalTime is true.
XDCGJobExcessiveQueueTime
Monitor job queue time. Issue a Critical alert when the job is in a queue for longer than 10 minutes. The formula is:
If
WebSphereXD_Jobs.Queue_Time is greater than 10
then
the situation XDCGJobExcessiveQueueTime is true.
Parent topic:
WebSphere XD Overview for ITCAM Agent for WebSphere Applications