Control Event Volume

Control Event Volume tool The Control Event Volume tool filters events with multiple observations based on a time span and count. New track observations that fall beneath the count threshold for the current time span are retained. New track observations that exceed the count threshold for the current time span are discarded.

Examples

  • A construction company wants to be notified when a vehicle unexpectedly leaves a job site. They want to be notified when it first happens and once more if it continues. The vehicles report their location every 5 minutes. To avoid sending an email every 5 minutes that a vehicle's location remains outside a job site, the Control Event Volume tool can be configured to allow 2 events, or emails in this case, every hour. This ensures an email is sent the first time a vehicle is outside a job site and once again 5 minutes later if it remains outside the job site. No additional messages will be sent for that vehicle until an hour has passed.
  • A temperature sensor reports the temperature every 10 seconds. Operations personnel want to receive a text message when the temperature is above safe levels. To avoid sending a text message every 10 seconds that the temperature is reported to be too hot, the Control Event Volume tool can be configured to allow 1 event, or text message in this case, every 3 minutes. This will send a text message the first time the temperature has exceeded safe levels and once again 3 minutes later if the temperature continues to exceed what is considered a safe level.

Usage notes

  • This tool only processes events with a unique Track ID. A Track ID must be identified on the input dataset to use this tool.

Parameters

ParameterDescriptionData Type

Interval

The time span that each track observation will be evaluated for filtering. This interval repeats for as long as the analytic is running.

String

Max Events Per Interval

The total number of repeat track observations that can be processed in an interval.

Integer

Considerations and limitations

  • The tool discards track observations that exceed the Max Events Per Interval for the current interval. These events are not cached or queued. If maintaining all track observations is important, consider branching the analytic to store the same data as features in a feature layer or cloud storage output.