How tarun-227/ebpf-stall-fingerprinting works
This repository is a Linux eBPF research tool for explaining application-operation stalls. Its main workflow runs marked workloads under the tracer, turns kernel events and per-operation ground truth into time breakdowns and features, then classifies operations as I/O-, scheduler-, CPU-dominated, or indeterminate. Separate analysis covers injected-delay fidelity and tracing overhead; processed results also feed report assets. The workflow and several connections are documented in the README; unsampled subsystems are included only where their purpose is documented, without asserting unverified call paths.
Main entry points: stalltrace.c Stalltrace collector · experimental_results Processed results · stallbench.c Stallbench workloads · stalltrace.bpf.c Kernel probes
Components 17
Workload tracing
- Stallbench workloads
code/src/workloads/stallbench.c - Stalltrace collector
code/src/collector/stalltrace.c - Kernel probes
code/src/ebpf/stalltrace.bpf.c - Event schema
code/src/ebpf/stalltrace.h - Trace and run data
code/src/collector/stalltrace.c
Timeline analysis
- Timeline breakdown
code/src/correlation/breakdown.py - Operation features
code/src/classifier/features.py
Classification
- Live trace labeling
code/src/label_trace.py - Rules and trees
code/src/classifier/models.py
Evaluation outputs
- Classifier evaluation
code/src/classifier/evaluate.py - Delay analysis
code/src/classifier/delay_analysis.py - Overhead analysis
code/src/classifier/overhead.py - Report assets
code/src/report/make_assets.py - Processed results
supplementary/experimental_results
Other components
- Experimenter
- Traced target
- Linux kernel
Connections 22
- Experimenter → Stallbench workloads: runs workload
README.md - Experimenter → Stalltrace collector: starts tracing
README.md - Traced target → Stalltrace collector: runs under
README.md - Stallbench workloads → Stalltrace collector: marks operations
README.md - Stallbench workloads → Trace and run data: records ground truth
README.md - Stalltrace collector → Kernel probes: loads programs
README.md - Kernel probes → Linux kernel: hooks kernel events
README.md - Kernel probes → Event schema: emits records
code/src/ebpf/stalltrace.bpf.c - Stalltrace collector → Event schema: decodes records
code/src/collector/stalltrace.c - Stalltrace collector → Trace and run data: writes events
README.md - Trace and run data → Timeline breakdown: provides trace and truth
README.md - Timeline breakdown → Operation features: provides breakdown rows
code/src/classifier/features.py - Operation features → Classifier evaluation: supplies feature table
code/src/classifier/evaluate.py - Classifier evaluation → Rules and trees: builds classifiers
code/src/classifier/evaluate.py - Trace and run data → Live trace labeling: provides trace
code/src/label_trace.py - Live trace labeling → Timeline breakdown: uses timelines
code/src/label_trace.py - Live trace labeling → Rules and trees: applies rules
code/src/label_trace.py - Operation features → Delay analysis: supplies feature table
code/src/classifier/delay_analysis.py - Classifier evaluation → Processed results: produces metrics
README.md - Delay analysis → Processed results: reports delay fidelity
README.md - Overhead analysis → Processed results: reports tracing cost
README.md - Processed results → Report assets: feeds report assets
code/src/report/make_assets.py