3 Futures Tracing
The futures trace module exposes low-level information about
the execution of parallel programs written using future.
Is equivalent to:
procedure enables the collection
of future-related execution data. This function should be called immediately
prior to executing code the programmer wishes to profile.
The stop-future-tracing! procedure must be used to indicate the
end of code the programmer wishes to trace. Tracing works by simply using a
log receiver to record all future-related log events; this procedure logs a
special message that is well-known to the log receiver to mean ’stop recording’.
The timeline-events procedure returns the program trace as
a list of indexed-future-event structures.
Represents an individual log message in a program trace. In addition to
future events, the tracing code also records garbage collection events; hence
field may contain either a future-event
struct (see Garbage Collection
where the latter describes a GC operation. Because multiple
structures may contain identical timestamps, the
field ranks them in the order in which they were recorded
in the log output.