# jfernandez/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.

Repository: https://github.com/jfernandez/bpftop
Canonical: https://ross.abutalabs.com/products/bpftop
Homepage: https://bpftop.sh
Language: C
License: Apache-2.0
License Family: permissive
Topics: bpf, ebpf, linux, cli
Last push: 2026-08-01T20:15:37+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 58, longevity 66
- inputs: {"age_days": 935, "days_push": 32, "days_rel": 123, "gap_med": 101.0, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2702, forks 129 (observed 2026-08-28T04:07:11.447159+00:00)

## What it is
bpftop is a top-like terminal tool that provides a dynamic real-time view of running eBPF programs on Linux, showing average runtime, events per second, and estimated CPU utilization per program. It minimizes overhead by enabling kernel performance statistics only while the tool is active and includes interactive filtering, sorting, and time-series graphs.

## Use cases
- monitor cpu usage of running ebpf programs
- find which bpf programs are consuming the most cpu
- view events per second for loaded ebpf programs
- debug performance of ebpf programs in real time
- plot ebpf program runtime over time
- list processes holding references to ebpf programs

## When to choose
- you need a top-style interactive view of eBPF program performance on Linux
- you want low-overhead stats collection that only runs while monitoring
- you need time-series graphs and filtering for eBPF programs
- you're on kernel 5.8+ or need procfs fallback for older kernels

## When to avoid
- you're not on Linux or lack root/CAP_BPF privileges
- you need non-interactive scripted metrics collection rather than a TUI
- you need to profile non-eBPF workloads

## Facets
- artifact type: cli-tool
- maturity: active
- function: monitoring, cli, developer-tools
- domain: developer-tools, monitoring, operating-systems, performance
- platform: cli
- tags: ebpf, bpf, top-like, terminal-ui, performance-profiling, kernel, linux

## Member repositories
- jfernandez/bpftop (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:11.447159+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:15:57.677607+00:00, confidence not recorded.
  - readme: https://github.com/jfernandez/bpftop (fetched 2026-08-28T04:07:11.447159+00:00, sha 1649951af1b8)
  - homepage: https://bpftop.sh (fetched 2026-08-29T09:58:59.194163+00:00, sha da742c1a62ee)
- Data as of 2026-08-30T08:39:29.467469+00:00.
