Skip to content
forked from Netflix/bpftop

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.

License

Notifications You must be signed in to change notification settings

arasakaos/bpftop

This branch is 29 commits behind Netflix/bpftop:main.

Folders and files

NameName
Last commit message
Last commit date
Feb 13, 2024
Jun 10, 2024
Jun 9, 2024
Jul 4, 2024
May 21, 2024
May 8, 2024
May 20, 2024
Jul 2, 2024
Jul 2, 2024
Jun 9, 2024
Feb 13, 2024
Feb 19, 2024
Jun 10, 2024
Feb 21, 2024
Feb 22, 2024
May 20, 2024
May 8, 2024

Repository files navigation

bpftop

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.

bpftop

Installation

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 bpftop

or install via your distribution's package manager:

Packaging status

Arch Linux

You can install bpftop from the official repositories using pacman:

pacman -S bpftop

Nix

You can install bpftop from the NixOS 24.05 stable channel:

nix-channel --add https://nixos.org/channels/nixos-24.05 nixpkgs
nix-channel --update
nix-env -iA nixpkgs.bpftop

Features

  • 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

Prerequisites

  • bpftop requires sudo privileges to run.
  • The binary is dynamically linked to libz and libelf, so these libraries must be present on the systems where you intend to run bpftop.

Usage

Run the following command to start bpftop on your host:

sudo ./bpftop

Relate links

How it works

bpftop 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.

Building from source

  1. Install and setup cross
  2. Run cross build --release for x86_64
  3. Run cross build --target=aarch64-unknown-linux-gnu --release for Arm64

About

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.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C 92.2%
  • Rust 7.8%