Reference to the until() function
Summary
until(<eventsExpression>)
Returns synthetic events that start at the beginning of epoch time (Jan 1, 1970) and end where the input events start.
Parameters
| Parameter | Description |
|---|---|
| eventExpression | Set of events that determine the ends of the returned synthetic events. |
Description
The until() event function returns a set of synthetic events, where each synthetic event:
- Starts at the beginning of epoch time (Jan 1, 1970)
- Ends at the start time of a corresponding event described by the expression.
The following diagram represents an events() query that returns 3 events (A, B, and C). Using that events() query as the input to until() produces 3 synthetic events that each end when the corresponding input event begins:

Note: Synthetic events are displayed by the query, but are not stored.