1 Execution Timeline
The execution timeline, shown in the top left-hand corner of the profiler window, displays a history of the program and all events associated with its futures, with OS-level threads or processes organized along the y-axis and time increasing along the x-axis. Garbage collections are shown as translucent maroon bars spanning the height of the timeline. A coloring convention is used to distinguish between different types of events (see Future Performance Logging for a full description of these event types):
Blue dot: 'create
Green bar: 'start-work, 'start-0-work
Orange dot: 'sync
Red dot: 'block, 'touch
White dot: 'result, 'end-work
Green dot: 'touch-pause, 'touch-resume
Maroon bar: 'gc
Mousing over any non-GC event connects it via purple lines to the sequence of events for its future. Additionally, orange dotted lines with arrowheads may be shown to indicate operations performed from one future to another (e.g. 'create or 'touch actions). To view details about two events simultaneously, a selection can be tacked by clicking the mouse.
The timeline displays vertical lines at 100-microsecond intervals. Note that though the time interval is fixed, the pixel distance between lines varies based on the event density for any given time range to prevent overlapping event circles.
procedure
(timeline-pict events [ #:timeline-width timeline-width #:x x #:y y #:width width #:height height #:selected-event-index selected-event-index]) → pict? events : (listof indexed-future-event?) timeline-width : exact-nonnegative-integer? = 1000 x : (or #f exact-nonnegative-integer?) = #f y : (or #f exact-nonnegative-integer?) = #f width : (or #f exact-nonnegative-integer?) = #f height : (or #f exact-nonnegative-integer?) = #f selected-event-index : (or #f exact-nonnegative-integer?) = #f
Changed in version 1.1 of package future-visualizer: Added the #:timeline-width argument.