Skip to content

Commit e5b98f5

Browse files
authored
Update windows docs with info about keyed watermarks (#607)
1 parent 61023fb commit e5b98f5

File tree

1 file changed

+10
-9
lines changed

1 file changed

+10
-9
lines changed

docs/windowing.md

Lines changed: 10 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -20,17 +20,19 @@ There are two types of time in streaming systems:
2020
2. **Processing time** - the time when the event is processed by the system
2121

2222

23-
In Quix Streams, **windows always use event time**.
23+
!!! info
2424

25-
The event time is obtained from the timestamps of incoming Kafka messages.
25+
In Quix Streams, **windows always use event time**.
26+
The event time is obtained from the timestamps of incoming Kafka messages.
2627

27-
A Quix Streams application keeps its own "clock" for each assigned partition.
28-
The state store tracks the **maximum observed timestamp** across incoming events within each topic partition, and
29-
this timestamp is used as a current time in the stream.
30-
What's important, it can never go backward.
31-
32-
When the application gets an event timestamp for the event, it assigns an interval according to the window definition.
28+
Every windowed aggregation tracks the event time for each **message key**.
29+
It stores the **maximum observed timestamp** for each **message key**, and
30+
this timestamp is used as a current time in the stream.
3331

32+
The maximum observed timestamp is used to determine whether the incoming event is late or on-time.
33+
See [Lateness and Out-of-Order Processing](#lateness-and-out-of-order-processing) for more info about lateness.
34+
35+
3436
### Extracting timestamps from messages
3537
By default, Quix Streams uses Kafka message timestamps to determine the time of the event.
3638

@@ -660,7 +662,6 @@ The appropriate value for a grace period varies depending on the use case.
660662

661663

662664

663-
664665
## Emitting results
665666

666667
Quix Streams supports 2 modes of emitting results for time windows:

0 commit comments

Comments
 (0)