Define an Event

When you define an event, you build an expression — the condition for which you want to be notified. An expression includes the measurement variable, type of object the event is measuring (link, class, or partition), and a relational operator (such as >). Here's an example of an expression you could build:

network-delay-avg.class>$1

This expression looks at the network-delay-avg measurement variable for a class and checks whether it is greater than a threshold variable (represented by $1). The class name and the threshold value are not set when you define the event — they are set when you register it.

To define a new event:

1. Access the CLI.

2. Type event new and press Enter.

3. Enter a descriptive name for the event (spaces are not allowed).

4. Specify the type of object the event is measuring: enter l for link, p for partition, or c for class.

5. Type the name of the measurement variable (see Measurement Variables). Be sure to type the variable exactly as it's listed in the table.

6. Enter the default checking interval (for example, 1m for one minute, 1h for one hour).

Note: When setting the notification-checking interval, take into account the sampling interval of the measurement variable. Variables are sampled on one-minute and one-hour intervals so valid checking intervals are 1m or 1h. For PacketShaper ISP models, variables are sampled on one-minute and four-hour intervals, with valid checking intervals of 1m or 4h.

7. Enter a relational operator.

You can define a maximum of 32 events, in addition to the predefined events included with PacketWise.

Once you have defined an event, you can register it. When you register an event, you supply a threshold value, which serves as the trigger for event notification. See Register an Event.

Note: An alternative way to monitor a specific class, link, or partition and receive notification when a threshold crossing has occurred is to create User Event Emulation agents with the adaptive response feature.