2.0 KiB

Raw Blame History

below

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)
record mode to record system data
replay mode to replay historical system data
live mode to view live system data
dump subcommand 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.

Demo

Installing

First, install dependencies listed in building.md.

$ cargo install below
$ below --help

For convenience, we also provide a Dockerfile and pre-built images on Docker Hub. See docker.md for how to use them.

Quickstart

Live view of system:

$ sudo below live

Run recording daemon:

$ sudo cp ~/.cargo/bin/below /bin/below  # if using cargo-install
$ sudo cp resctl/below/etc/below.service /etc/systemd/system
$ sudo systemctl daemon-reload
$ sudo systemctl start below

Replay historical data:

$ below replay -t "3m ago"

Comparison with alternative tools

See comparison.md for a feature comparison with alternative tools.

Contributing

See the CONTRIBUTING file for how to help out.

License

See LICENSE file.

2.0 KiB Raw Blame History