event history

event history Structure: Event history.

event history structure
event ID unique ID
last triggered date: optional
last started date: optional
last finished date: optional
trigger count integer: optional
perform count integer: optional

Description

A history of each event is kept. The history represents the behaviour of the event with a given unique ID. The history is maintained for as long as the event exists.

Fields

event ID

Unique identifier of the represented event.

The event ID is included to help clients issuing multiple event history requests track responses.

last triggered

Date the event was last triggered.

The most recent date the event was triggered. If an event has multiple triggers, this date refers to the most recent trigger.

If last triggered is not present, the event has not been triggered.

last started

Date the event was last performed.

The most recent date the event started performing. The event will perform if triggered, and then only if all the conditions are met. last started represents the date the trigger and conditions were successfully met.

If last started is not present, the event has not been performed.

last finished

Date the event last finished performing.

The most recent date the event finished performing.

last started may be more recent than last finished. This can happen when an event may be performed concurrently; one instance finished while a second started slightly later and is still running.

If last finished is not present, the event has not finished being performed.

trigger count

Number of times the event has been triggered.

An event may be triggered may times before its conditions are met. This value is incremented each time an event's trigger is fired, regardless of whether any conditions are met.

perform count

Number of times the event has been performed.

Count of the number of times an event has been triggered, and any conditions are met.

The count is incremented when the event's performance begins.