1 unstable release
|0.1.0||Nov 7, 2020|
resctl is an umbrella repository for resource control projects at Facebook.
below is an interactive tool to view and record historical system data. It
has support for:
- information regarding hardware resource utilization
- viewing the cgroup hierarchy
- cgroup and process information
- pressure stall information (PSI)
recordmode to record system data
replaymode to replay historical system data
livemode to view live system data
dumpsubcommand to report script-friendly information (eg json and csv)
below does not have support for cgroup1.
The name "below" stems from the fact that the below developers rejected many of atop's design and style decisions.
See comparison.md for a feature comparison with alternative tools.
procfs is a rust library that parses
cgroupfs is a rust library that parses
Live view of system:
$ podman run --privileged --cgroupns=host --pid=host -it below/below:latest
Run recording daemon:
$ sudo cp resctl/below/etc/below.service /etc/systemd/system $ sudo systemctl daemon-reload $ sudo systemctl start below
Replay historical data:
$ podman run --mount='type=bind,src=/var/log/below,dst=/var/log/below' -it below/below replay -t "3m ago"
See docker.md for more details.
Alternatively, see building.md for non-docker build instructions.
See the CONTRIBUTING file for how to help out.
See LICENSE file.