SEAPATH scripts

Ease SEAPATH debug and deployment

QEMU threads report

Display QEMU/KVM thread ID, name, scheduler, RT priority, priority, last CPU, and effective affinity per VM. Pass a VM name to output only that VM and its associated kvm-pit task.

./qemu_threads_report.py
./qemu_threads_report.py vmname
./qemu_threads_report.py --json

Run as root for complete QEMU command-line and thread visibility. LAST_CPU is procfs last-scheduled CPU snapshot, not proof thread executes on CPU while report prints.

Example:

=== VM: rtvm (PID 1580) ===
    TID  THREAD                   SCHEDULER       RTPRIO PRIO LAST_CPU  AFFINITY
   1580  qemu-system-x86          SCHED_OTHER          0   19        9  9
   1583  qemu-system-x86          SCHED_OTHER          0   19        9  9
   1588  vhost-1580               SCHED_RR             1   41        9  9
   1589  IO mon_iothread          SCHED_OTHER          0   19        9  9
   1590  CPU 0/KVM                SCHED_FIFO           1   41        5  5
   [...]

=== KVM PIT for VM: rtvm (QEMU PID 1580) (PID 1593) ===
    TID  THREAD                   SCHEDULER       RTPRIO PRIO LAST_CPU  AFFINITY
   1593  kvm-pit/1580             SCHED_RR             1   41        9  9

CPU task report

Display every process thread last scheduled on selected CPU. Pass --allowed to also display threads whose effective affinity allows selected CPU but last scheduler snapshot is elsewhere. When multiple CPUs are selected, tasks are grouped by last CPU.

./cpu_tasks_report.py 4
./cpu_tasks_report.py 4-12 --json --allowed

Example:

Selected CPU(s): 5
Last CPU is procfs scheduling snapshot, not instantaneous execution.

Last scheduled on selected CPU(s): 13
    PID     TID  PROCESS                  THREAD                   LAST_CPU  AFFINITY
     67      67  cpuhp/5                  cpuhp/5                         5  5
     68      68  irq_work/5               irq_work/5                      5  5
     69      69  migration/5              migration/5                     5  5
     70      70  rcuc/5                   rcuc/5                          5  5
     [...]

Run as root for complete task visibility. LAST_CPU is procfs last-scheduled CPU snapshot, not proof thread executes on CPU while report prints.

Network IRQ report

Display one IRQ table per physical network interface. Tables include IRQ number, thread ID, IRQ name, scheduler, RT priority, priority, last CPU, and effective IRQ affinity. Thread and scheduler fields for hard IRQs or invisible IRQ threads are ?.

./network_irq_report.py
./network_irq_report.py eno1
./network_irq_report.py --json

IRQ discovery uses device msi_irqs and legacy irq sysfs entries, with /proc/interrupts name matching as fallback. Run as root for complete IRQ thread visibility. Pass an interface name to output only that network card.

Example:

=== eno1 (pci0000:00/0000:00:01.1/0000:01:00.0) ===
   IRQ     TID  IRQ_NAME                                   SCHEDULER       RTPRIO PRIO LAST_CPU  AFFINITY
    53       ?  ?                                          ?                    ?    ?        ?  ?
    57     879  IR-PCI-MSIX-0000:01:00.0 0-edge eno1-tx-0  SCHED_FIFO          50   90        7  7
    58     880  IR-PCI-MSIX-0000:01:00.0 1-edge eno1-rx-1  SCHED_FIFO          50   90       14  14
    59     881  IR-PCI-MSIX-0000:01:00.0 2-edge eno1-rx-2  SCHED_FIFO          50   90        5  5
    60     882  IR-PCI-MSIX-0000:01:00.0 3-edge eno1-rx-3  SCHED_FIFO          50   90       12  12
    61     883  IR-PCI-MSIX-0000:01:00.0 4-edge eno1-rx-4  SCHED_FIFO          50   90        3  3