[PATCH v7 0/2] perf timechart: Add --live mode to the TUI and test

From: Ian Rogers

Date: Fri Nov 13 2026 - 03:38:07 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

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 | 1244 +++++++++++++++--
.../tests/shell/test_ttimechart_python.sh | 436 ++++++
4 files changed, 1683 insertions(+), 97 deletions(-)

--
2.56.1.703.gf848ed807c-goog