feat(timing): time garbage-collection pauses in the frame stats (#722)

A GcMonitor in src/common/frame_timing.py, installed once per process from gc.callbacks by the display manager (and render_bench), counts collections and seconds per generation, the longest, and those of 20 ms or more. A long one tags the next presented frame 'gc' in record(), so frame_soak shows its late rate under 'after work'; the stats file gains an additive 'gc' block printed as a 'Garbage collection' line; and a Render stall dump says when a long collection ran inside the stall. Diagnostic only: nothing tunes, freezes or disables the collector. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-04 14:25:08 +00:00 · 2026-10-01 21:29:08 -04:00
parent 85be4bf25d
commit 5aa7a63127
7 changed files with 288 additions and 4 deletions
@@ -438,6 +438,7 @@ def main(argv=None) -> int:
        flush_interval=float("inf"),
        info=display._frame_timing_info(),  # pylint: disable=protected-access
        refresh_hz=idle_hz,
+        gc_monitor=frame_timing.install_gc_monitor(),
    )
    recorder.scrolling_now = display._scrolling_now  # pylint: disable=protected-access
    display.frame_timing = recorder