[PATCH v8 0/2] perf timechart: Add --live mode to the TUI and test
From: Ian Rogers
Date: Fri Nov 13 2026 - 11:58:31 EST
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
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