IBM Tivoli Software IBM Tivoli Software

[ Bottom of Page | Previous Page | Next Page | Contents | Index ]


Editing events

Objective

To define an indication for the resource model and the aggregation settings that determine when a sequence of indications produce an event.

Background information

When you define an event, you must specify the attributes that qualify it. In particular, you must select the most significant attribute for the aggregation process.

While defining an event, you can also indicate if you want the system to notify the Tivoli Enterprise Console server and Tivoli Business Systems Manager that an event was generated. The IBM Tivoli Monitoring operator can change these selections when the resource model is included in an IBM Tivoli Monitoring profile. You can also define the degree of severity and the message that specifies the notification of the event.

Before you begin

None

When you finish

Check the Tasks view to verify that you do not have any errors in your resource model. If the Tasks view displays errors, correct the errors before running the resource model. The Tasks view displays in the bottom pane of the IBM Tivoli Monitoring Resource Model Builder.

Procedure

  1. Open the resource model.
  2. Select the Events page.
  3. Edit an existing event or click Add Event to add a new event to the resource model.

    Additional Information: Customize the following event options:

    Internal Name
    The internal name of an event must be unique within the entire set of resource models installed on a specific IBM Tivoli Monitoring server. If two or more resource models specify events with identical names, then you cannot install those resource models on the same IBM Tivoli Monitoring server. Follow naming conventions and best practices as described in Designing a resource model.
    Descriptive name
    The descriptive name of this event that is informative and recognizable for logging and reporting information.
    Message
    The message the event sends to the Tivoli Enterprise Console server or Tivoli Business Systems Manager. When typing the message, specify event attributes that are variables between "@" symbols. For example: "This process @ProcessName@, @ProcessID@ is consuming too much CPU."
    Send to TBSM
    To send the event notification to the Tivoli Business Systems Manager server as a default.
    Send to TEC
    To send the event notification to the Tivoli Enterprise Console server as a default. When you select Send to TEC the Default Event Hierarchy check box displays.
    Default Event Hierarchy
    Clear this box to create event hierarchy in Tivoli Enterprise Console by specifying a parent for this event in the Event Parent text box. By default, this box is selected and the event parent is set to TMW_EVENT.
    Event Parent
    The parent of this event in the Tivoli Enterprise Console hierarchy. This enables you to organize events into hierarchies that are understood by the Tivoli Enterprise Console. When the resource model is saved, the parent is saved to the workspace XML file. By default, the event parent is set to TMW_EVENT.
    Severity
    The degree of severity for notification to the Tivoli Enterprise Console server or Tivoli Business Systems Manager. Make a selection from the drop-down list.
    Description
    The descriptive text that is displayed on the IBM Tivoli Monitoring windows and that provides information for the operator running the resource model.
    Attributes
    Add or remove attributes from the event. Attributes detail an event by enabling you to get as much information as you need from the event. For example, an event might indicate that your disk subsystem has problems, but by associating attributes such as, bytes per second, disk name, or available disk space you can more easily identify the problem.

    Do the following to add an attribute:

    1. Click Add or right-click inside the table.
    2. Enter the name of the attribute in the Name column.
      Note:
      If you are going to enable logging for this resource model, use the same names for attributes here and in the logging definitions when specifying the same metric.
    3. Select the Type column and select the type from the drop-down list.
    4. Select the Is Key column to make this the key attribute. When selected, a check mark displays in this column. Key attributes are the most meaningful and play a fundamental role in the event aggregation process.

    Use the up and down arrow buttons to specify the order of the attributes.

    Click Remove to remove the selected attribute from the event.

    Aggregation Settings
    The conditions under which this indication becomes an aggregated event. Only aggregated events trigger actions, notify you of a problem, and send notification to the Tivoli Enterprise Console and Tivoli Business Systems Manager.
    Clearing Event
    Select Clearing Event if you want the system to send a clearing event when the circumstances that generated the event are resolved.

    The Tivoli Enterprise Console server and Tivoli Business Systems Manager use the clearing event to close the corresponding error event.

    For example, if the resource being monitored is a service, the event is sent when the service is not available. The event might have an action associated with it to restart the service (or the restart might be done manually). When the engine detects that the service is available again, a clearing event can be sent to close the original event.

    Number of occurrences
    The number of indications that must occur before an event generates. The number of occurrences must be greater than zero. This is the default value for this resource model. You can change this value at runtime in the IBM Tivoli Monitoring application.
    Number of holes
    The maximum number of monitoring cycles allowed with no indications for an event to be generated. The number of holes must be greater than or equal to zero. This is the default value for this resource model. The user can change this value at runtime in the IBM Tivoli Monitoring application.
  4. (Optional) Click Action to associate a recovery action with the event, as described in Adding Actions.
  5. Save the changes and close the resource model, or go to another editing page.

[ Top of Page | Previous Page | Next Page | Contents | Index ]