Re: [PATCH v8 0/2] perf timechart: Add --live mode to the TUI and test
From: Ian Rogers
Date: Sun Nov 22 2026 - 12:01:20 EST
On Fri, Nov 13, 2026 at 7:26 AM Ian Rogers <irogers@xxxxxxxxxx> wrote:
>
> Add a '--live' option to 'perf timechart' and 'ttimechart.py' that streams
> live scheduler, power, or I/O (-I/--io-only) events from a 'perf record'
> subprocess over a pipe and displays them in the Textual TUI with a rolling
> time window (--window, default 10s), pause/resume via the control pipe, an
> optional workload after '--' that stops recording when it exits, and
> optional output recording (-o), along with headless shell tests in
> test_ttimechart_python.sh.
>
> Assisted-by: Antigravity:gemini-3.1-pro
>
> v8: Address Sashiko review feedback:
> - Patch 1: Track switch-out timestamps explicitly on Task rather than
> inferring switch counts from pruned STATE_RUNNING segments, and
> accumulate Task.totals from the actual clipped duration returned by
> SegmentList.add() while keeping Task.since monotonic.
> - Patch 1: Keep each I/O syscall as its own unmerged segment and avoid
> same-timestamp clipping so Task.io_bytes and syscall counts never
> drift across pruning.
> - Patch 1: Extend open STATE_WAITING and STATE_BLOCKED task states in
> checkpoint(), preserve non-sleeping states across prune(), and clamp
> live_prune() to last_time - 1 so open or finished states at last_time
> are not deleted when idle past --window.
> - Patch 1: Refresh comm names from perf.session on syscall lookups and
> periodic live intervals (ignoring perf's unset ':tid' placeholders) so
> pre-exec names update after execve(), and ignore scheduler-only tasks
> in dump() and the UI when -I is set.
> - Patch 1: Snapshot flush_round_target with a sequence counter before
> draining perf record's pipe so concurrent or split-record flushes are
> not dropped, and synchronize LiveRecorder.backlog() with
> close_data_fds() under fd_lock.
> - Patch 2: Add synthetic regression tests for all cases.
>
> v7: Address Sashiko review feedback:
> - Patch 1: Pass the comm/PID filter expression as a positional
> argument to /bin/sh so the shell preserves the quotes around comm in
> --live -I mode instead of stripping them before execing perf record.
> - Patch 1: Clear LiveRecorder.control_thread if starting it raises so
> stop() does not call join() on an unstarted thread and skip FD/comm
> cleanup, and ignore OSError if perf record exits concurrently during
> stop().
> - Patch 2: Test the /bin/sh --filter quoting and control_thread
> startup failure cleanup in the synthetic live test, and add a live
> -I workload recording subtest when syscall tracepoints are permitted.
> v6: https://lore.kernel.org/lkml/20261112233738.699031-1-irogers@xxxxxxxxxx/
>
> v6: Rebase onto perf-tools-next and address Sashiko review feedback:
> - Patch 1: Queue pause/resume gap timestamps in a deque so rapid
> pause/resume cycles before buffered events arrive still close
> pre-pause open task and CPU states at each gap.
> - Patch 1: Increment nr_samples inside TimechartData.lock and check/update
> refreshed_samples in the same lock acquisition as checkpoint() in
> live_refresh() so final buffered events aren't missed when paused.
> - Patch 1: Keep cursor following in sync when zooming in/out, resetting
> zoom with '0' after moving the cursor, or jumping to a waker ('w').
> - Patch 1: Filter out all threads of ttimechart.py (via comm) and the
> child perf record process (via $$) on syscall tracepoints in --live -I
> mode, and ignore filtered I/O events before counting nr_samples.
> - Patch 1: Track record boundaries in LiveRecorder's pipe pump and emit a
> synthetic PERF_RECORD_FINISHED_ROUND when perf record goes idle or
> pauses so ordered_events does not hold back the latest round.
> - Patch 1: Always drain perf record's stdout on stop so perf record can
> flush and terminate its workload cleanly without blocking on pipe writes,
> and kill its process group if wait times out.
> - Patch 2: Gate the LiveRecorder task-clock subtest on system-wide
> task-clock permissions so unprivileged runs under perf_event_paranoid > 0
> skip cleanly, and add synthetic tests for multiple pause gaps, round
> tracking, and cursor following.
> v5: https://lore.kernel.org/linux-perf-users/20261023054952.2503540-1-irogers@xxxxxxxxxx/
>
> v5: Address Sashiko review feedback:
> - Patch 1: Always record system wide, as 'perf timechart record'
> does, as switches into a task and idle states aren't seen by
> per-task events when only a workload was recorded.
> - Patch 1: Don't move a task's state start back before its recorded
> history when its switch out and back in were lost, which inflated
> its running time.
> - Patch 1: Serialize LiveRecorder.stop() calls from the UI thread and
> the thread processing events.
> - Patch 2: Only run the live recording test when scheduler events can
> be recorded system wide.
> v4: https://lore.kernel.org/linux-perf-users/20261023050207.2449976-1-irogers@xxxxxxxxxx/
>
> v4: Address Sashiko review feedback on patch 1:
> - Don't prune live history past the last event, so open states aren't
> lost when no events arrive for a window, and don't count a still
> running task's open segment as a switch.
> - Keep showing the window at the end of recording, rather than jumping
> back to already pruned history, and prune events flushed as perf
> record exits.
> - Close open task, CPU and I/O states when resuming after a pause,
> rather than extending them across the unrecorded gap, and close the
> running task when a switch away from it was lost.
> - Stop perf record and close the files and pipes if
> LiveRecorder.start() fails after starting it, and close the data pipe
> read ends in LiveRecorder.stop().
> v3: https://lore.kernel.org/linux-perf-users/20261023041819.2361900-1-irogers@xxxxxxxxxx/
>
> v3: Address Sashiko review feedback:
> - Patch 1: Explicitly include <string.h> in builtin-timechart.c.
> - Patch 1: Reject non-finite --window values (e.g. 'inf') that
> overflowed converting to nanoseconds.
> - Patch 2: Stop the fake recorder in a try/finally in the synthetic
> live UI test so a failed check can't leave its background thread
> running and hang the test.
> Rebase onto the latest perf-tools-next.
> v2: https://lore.kernel.org/linux-perf-users/20261014042249.2379829-1-irogers@xxxxxxxxxx/
>
> v2: Rebase the remaining 2 patches onto perf-tools-next after patches 1-11
> of v1 were merged.
>
> Alice Rogers (2):
> perf timechart: Add a --live mode to the TUI
> perf test: Test perf timechart --live
Ping. The Sashiko feedback is now clean on these final 2 remaining patches:
https://sashiko.dev/#/patchset/20261113152622.1991001-1-irogers@xxxxxxxxxx
Thanks,
Ian
> tools/perf/Documentation/perf-timechart.txt | 20 +-
> tools/perf/builtin-timechart.c | 80 +-
> tools/perf/python/ttimechart.py | 1334 +++++++++++++++--
> .../tests/shell/test_ttimechart_python.sh | 591 ++++++++
> 4 files changed, 1899 insertions(+), 126 deletions(-)
>
> --
> 2.56.1.703.gf848ed807c-goog
>