Skip to main content

Module obs

Module obs 

Source
Expand description

The observation channel for COMPILED (AOT-Rust) programs — Wave 13.

Emitted-Rust programs compiled in the OBSERVED profile call these functions for Note/Warn/Record/During, so the compiled binary produces the same observation event stream the interpreter and VM do (the compile-side buffer lives in logicaffeine_compile::observe; this is its standalone-runtime twin, reachable from generated code via use logicaffeine_system::*). Events land in a thread-local buffer a host sink drains; when nothing is installed, emission is a cheap no-op, so the release (elided) profile — which never emits these calls at all — pays exactly nothing.

Structs§

ObsEvent
One observation event captured in a compiled program.

Functions§

capturing
Is a sink capturing on this thread? (Emission is a no-op otherwise.)
drain
Take and clear the captured events (empty if nothing was installed).
install
Begin capturing observation events on this thread (a fresh, empty buffer).
record
Emit a Note/Warn/Record message with its captured payloads.
span_enter
Emit a During span entry.
span_exit
Emit a During span exit (always paired with its span_enter).