Setting a Server Resource trap

About this task

A Server Resource trap measures various target types. The system will trigger a trap after exceeding the threshold for the metric you set.  When the system meets the definition of the trap an alert occurs. For example, set a trap to alert you when a server is unavailable two times, and after a server is unavailable you can select to receive an email.   

To set a Server Resource trap:

Procedure

  1. From the top navigation, click Problem Determination > Trap & Alert Management.
    The Trap and Alert Management page opens.
  2. On the left navigation pane, click Create Trap.
    The Trap Type selection page opens.
  3. Select Server Resource trap as the Trap Type.
  4. Select one of the following target types from the box.
    • CPU: Average Platform CPU % Usage - Based on the average platform CPU usage over 5 minutes, the Publish Server retrieves CPU usage at regular intervals (60 seconds by default) and calculates the average platform CPU over 5 minutes.
    • Average JVM CPU % Usage - Based on the average JVM CPU usage over 5 minutes, the Publish Server retrieves CPU usage at regular intervals (60 seconds by default) and calculates the average JVM CPU over 5 minutes.
    • Memory:
    • JVM Heap Size - Based on the JVM Heap Size of the data collector, the Publish Server retrieves JVM Heap Size from the data collector at regular intervals (60 seconds by default) and checks the heap size from that measure.
    • Garbage Collection Frequency - Garbage Collection is calculated over 1 minute (supported in ITCAM J2EE WebLogic).
    • Average JVM Heap Size after Garbage Collection - The trap triggers when the average JVM Heap size exceeds the size configured in the trap (supported in ITCAM J2EE WebLogic)
    • Application Capacity:
    • Number of Sessions - Based on the number of user sessions that are currently in use by the application server.
    • Average Response Time - If the average response time exceeds the time configured in the trap condition (supported in ITCAM J2EE WebLogic), the Publish Server triggers the trap .
    • Server available - Publish server triggers the trap when the server (data collector) becomes available (supported in ITCAM J2EE WebLogic).
    • Server unavailable - If the server (data collector) goes down or becomes unavailable (supported in ITCAM J2EE WebLogic), the Publish server triggers the trap .
    • Uncaught Java™ Exceptions - Based on the rate of the Java exceptions that occur in applications and includes data about the failure. It is calculated over 60 seconds. Publish server triggers the trap if the Servlet error rates exceed the number configured in the trap condition.
    • Request Frequency - Number of requests per minute.
    • Resource Pool :
    • Thread Pool % Usage - Publish Server triggers the trap if the Thread Pool % Usage of a particular server exceeds the threshold that is specified in the trap condition (supported in ITCAM J2EE WebLogic).
    • JCA Pool % Usage - Publish Server triggers the trap if the JCA Pool % Usage of a particular server exceeds the threshold that is specified in the trap condition (supported in ITCAM J2EE WebLogic).
    • JDBC Pool % Usage - Publish Server triggers the trap if the JDBC Pool % Usage of a particular server exceeds the threshold that is specified in the trap condition (supported in ITCAM J2EE WebLogic).
  5. Click Next.
    The Define Trap page opens.
  6. Enter a threshold that will send out an alert when it triggers the trap after meeting the condition.
  7. Click Next.
    The Set Trap Alerts page opens.
  8. For the Trap Alert settings, under Condition enter the number of times the trap occurs before the system takes an action. Specify the amount of time under Time Interval to monitor how many times the trap met its conditions.
  9. Click to select the severity level from the box.
    Note: The application monitor has three severity levels. Because the application monitor provides SNMP integration with Tivoli®, map the three severity levels of the application monitor to the warning levels of Tivoli listed in the following table:
    ITCAM severity level Tivoli warning level
    Low Harmless
    Medium Minor
    High Critical
  10. Select an action or multiple actions, such as sending an email or SNMP message, for the system to take when the condition is met.
  11. The Data Action–Heap Dump is only available if you select JVM Heap Size or Average JVM Heap Size after Garbage Collection as your Target type.
  12. Click Add to add the alert to your trap.
  13. Set the Default Suppression settings by entering the amount of time that you want to delay alerts after the first alert is sent.
  14. Click Next to proceed.
    The Name Trap page opens.
  15. Enter a name and descriptive text for your trap.
  16. Click either Save or Save & Activate.
  17. If you click Save, the Trap and Alert Management page opens displaying your new trap.
  18. If you click Save & Activate, the Activate page opens. To activate a trap, see Activating a Trap .

Results

If you select the <= operator while creating or modifying the Request Frequency target type, then the following sequence of events occurs:
  1. If no transactions are received by the Publish Server after activating the trap, the trap action does not trigger .
  2. Trap threshold checking begins after the first transaction received by the Publish Server activates the trap.
Tip: When setting a trap, you can select multiple trigger conditions and alerts for each action set. Each trap is required to have at least one action but can have multiple actions set.