IBM Tivoli Composite Application Manager for Application Diagnostics, Version 7.1.0.1
Situations for ITCAM Agent for J2EE
IBM Tivoli Composite Application Manager for Application Diagnostics Agent for J2EE provides 11 predefined situations that you can use to:
- Immediately begin monitoring your J2EE application servers
- Manage widely dispersed J2EE Application Server resources through localized automation
- Use models for creating your own situations
These predefined situations have an alert status of Critical. 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 J2EE application server for errors occurring within it or your site's Web applications.
How the situations work
Situations are tests expressed in an IF-TRUE format of system conditions to monitor; the tested value is an ITCAM Agent for J2EE attribute expressed in the form attribute-group.attribute-name. Thus, 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. Using this kind of expression prevents a situation from falsely tripping. If the ITCAM Agent for J2EE Tivoli Enterprise Management Agent encounters an undefined attribute value, it interprets this as a negative number and erroneously fires a situation that specified a negative number.
Predefined situations-descriptions and formulas
J2EEServletsJSPsError Monitors the error count for servlets and JSPs invoked by a J2EE Application Server application and issues a Critical condition whenever the count becomes nonzero. The J2SE application server does not support this situation. Its formula is as follows:
If
Servlets_JSPs.Error_Count is greater than 0
then
the situation J2EEServletsJSPsError is true.
J2EEError Monitors the error severity for a single J2EE Application Server and issues a Critical condition whenever that severity is greater than 21. The J2SE application server does not support this situation. Its formula is as follows:
If
Log_Analysis.Severity is greater than 21
then
the situation J2EEError is true.
J2EENotConnected Monitors the connection between the ITCAM for J2EE data collector running in an application server and the ITCAM Agent for J2EE monitoring agent to ensure the monitoring agent is connected and issues a Critical condition whenever it is not. Its formula is as follows:
If
Application_Server_Status.Status equals 0
then
the situation J2EENotConnected is true.
J2EEOutofHeapSpace Monitors the heap allocation status and issues a Critical condition whenever heap space is exhausted. The formula is as follows:
If
Allocation_Failure.Heap_Status equals 1
then
the situation J2EEOutofHeapSpace is true.
J2EEHighResponseTime Monitors the average request response time and issues a Critical condition whenever that time exceeds two seconds. The formula is as follows:
If
Request_Times_and_Rates.Average_Request_Response_Time is greater than 2000
then
the situation J2EEHighResponseTime is true.
J2EEHighCPUPercentUsed Monitors the percentage of the CPU being consumed and issues a Critical condition whenever that time exceeds 80%. The formula is as follows:
If
Application_Server.CPU_Used_Percent is greater than 80
then
the situation J2EEHighCPUPercentUsed is true.
J2EEHighGCTimePercent Monitors the percentage of time being spent by the garbage collector and issues a Critical condition whenever that time exceeds 80%. The formula is as follows:
If
Garbage_Collection_Analysis.Real_Time_Percent is greater than 80
then
the situation J2EEHighGCTimePercent is true.
J2EEAppDiscovered monitors J2EE applications deployed in the application server and issues an Informational alert when a new application is discovered. The monitoring agent checks for new applications each time when it connects to the data collector or when an application is deployed when the data collector is already active. The J2SE application server does not support this situation. The formula is:
If
Application_Monitoring_Configuration.Monitoring_Status equals 0
then
the situation J2EEAppDiscovered is true.
The predefined Take Action command Start_Baselining associated with the J2EEAppDiscovered situation enables you to automate the baselining of newly discovered applications.
J2EEAppHealthGood monitors the overall application health and issues an Informational alert when application health is good. The J2SE application server does not support this situation. The formula is:
If
Application_Health_Status.Application_Health equals 1
then
the situation J2EEAppHealthGood is true.
The predefined Take Action command Set_Application_Monitoring associated with the J2EEAppHealthGood situation lowers the request monitoring level for applications generated alert, and reduces the monitoring overhead.
J2EEAppHealthFair monitors the overall application health and issues a warning alert when application health is fair. The J2SE application server does not support this situation. The formula is:
If
Application_Health_Status.Application_Health equals 2
then
the situation J2EEAppHealthFair is true.
The predefined Take Action command Set_Application_Monitoring associated with J2EEAppHealthFair situation raises the request monitoring level for applications generated alert, and enables you to collect detailed performance data that will help to pinpoint a bottleneck down to particular application tiers.
J2EEAppHealthBad monitors the overall application health and issues a Critical alert when the application health is bad. The J2SE application server does not support this situation. The formula is:
If
Application_Health_Status.Web_Tier_Health equals 3
then
the situation J2EEAppHealthBad is true.
The predefined Take Action command Set_Application_Monitoring associated with J2EEAppHealthBad situation increases the request monitoring rate for applications generated alert, and enables you to collect more detailed performance data that will help to collect the most precise data about each application tier health level.
Additional information: Attributes for ITCAM Agent for J2EE
Parent topic:
ITCAM Agent for J2EE