bpftop provides a dynamic real-time view of running eBPF programs. It displays the average runtime, events per second, and estimated total CPU % for each program. It also provides graphical views of these statistics over time. This tool minimizes overhead by enabling performance statistics only while it is active.
To download the latest release of bpftop, use the following command:
curl -fLJ https://github.com/Netflix/bpftop/releases/latest/download/bpftop -o bpftop && chmod +x bpftopor install via your distribution's package manager:
- Displays a list of all running eBPF programs on the host, including the ID, type, and name
- Shows the period and total average runtime for each eBPF program.
- Calculates the events per second and estimated CPU utilization for each eBPF program
- Provides a graphical view of the average runtime, events per second, and estimated CPU utilization over a 10-second time period
- Dynamically updates the list every second
- Enables the statistics-gathering function only while it is active
bpftoprequiressudoprivileges to run.- The Linux kernel version must be 5.8 or later.
- The binary is dynamically linked to
libzandlibelf, so these libraries must be present on the systems where you intend to runbpftop.
Run the following command to start bpftop on your host:
sudo ./bpftopbpftop uses the BPF_ENABLE_STATS BPF syscall command to enable global eBPF runtime statistics gathering, which is disabled by default to reduce performance overhead. It collects these statistics every second, calculating the average runtime, events per second, and estimated CPU utilization for each eBPF program within that sample period. This information is displayed in a top-like tabular format. Once bpftop terminates, it disables the statistics-gathering function by deleting the file descriptor returned by BPF_ENABLE_STATS.
- Install and setup cross
- Run
cross build --releasefor x86_64 - Run
cross build --target=aarch64-unknown-linux-gnu --releasefor Arm64