scxtop is a top like utility for sched_ext schedulers. It collects and aggregates system performance metrics and scheduler events via bpf and aggregates the data in a live view across CPUs, LLCs, and NUMA nodes. It uses ratatui for rendering the TUI.

scxtop must be run as root or with capabilities as it uses perf_event_open as well as BPF programs for data collection. Use the help menu (h key is the default to see keybindings) to view the current keybindings:

scxtop has multiple views for presenting aggregated data. The bar chart view displays live value bar charts:

The sparkline view is useful for seeing a historical view of the metrics:

scxtop is able to generate Perfetto compatible traces. The trace data also contains DSQ (dispatch queue) data for any active sched_ext scheduler. Soft IRQs are also collected as part of the trace.

scxtop can be used to observe scheduling decisions across hardware boundaries by using the LLC aggregated view: For systems with multiple NUMA nodes aggregations can also be done at the NUMA level:

The scheduler view displays scheduler related stats. For schedulers that use scx_stats the stats will be collected and aggregated. The scheduler view displays stats such as DSQ latency, DSQ slice consumed (how much of the given timeslice was used), and vtime delta. Vtime delta is useful in understanding the progression of scheduler vtime. For most schedulers vtime delta should remain rather stable as DSQs are consumed. If a scheduler is using FIFO scheduling this field may be blank.