The <eventCountThreshold> element is valid only for the threshold rule. It defines the number of events that must meet the event selection criteria in a certain time period. The <eventCountThreshold> element also specifies one of two possible time interval modes, either fixed or sliding, for the time window.
event reception time + time interval duration for rule > current timeWhen no such event exists, the sliding interval cannot adjust the time any further, and the interval ends.
The time interval mode for the time window is defined by the timeIntervalMode attribute of the <eventCountThreshold> element. The following scenario illustrates the behavior of, and differences between, the two possible time interval modes.
The fixed mode is static.
The sliding mode is dynamic in that it continues to adjust (to slide) the beginning time in an attempt to meet its threshold within the time window.
At 8:09, when the time window is now scheduled to complete, the rule determines that it has received only 2 events. The rule then discards the event that it received at 8:04 and recalculates the duration to end at 8:11 (since the first event is now the one that it received at 8:06).
At 8:11, when the time window is now scheduled to complete, the rule determines that it has received only 2 events. The rule then discards the event that it received at 8:06 and recalculates the duration to end at 8:15 (since the first event is now the one that it received at 8:10).
At 8:15, when the time window is now scheduled to complete, the rule determines that it has received no events since the event at 8:10 that began the time window. The rule then runs the <onTimeOut> actions.
<eventCountThreshold> has the following attributes:
Name | Description | Data type | Required? |
---|---|---|---|
threshold | Defines the number of events that must meet the event selection criteria within a certain time period. This is the event count threshold that is to be met. This value must be a positive integer. | xsd:positiveInteger | Yes |
timeIntervalMode | Defines whether the time interval for the time window
is fixed or sliding. The valid values for this attribute are:
|
xsd:string | No |
<eventCountThreshold> contains no elements.