8 releases (5 breaking)

Uses new Rust 2021

0.6.3 Oct 28, 2022
0.6.2 Oct 6, 2022
0.5.0 Jan 28, 2022
0.4.1 Nov 11, 2021
0.1.0 Nov 7, 2020
Download history 9/week @ 2022-08-11 8/week @ 2022-08-18 17/week @ 2022-08-25 6/week @ 2022-09-01 30/week @ 2022-09-08 8/week @ 2022-09-15 15/week @ 2022-09-22 13/week @ 2022-09-29 42/week @ 2022-10-06 7/week @ 2022-10-13 10/week @ 2022-10-20 36/week @ 2022-10-27 31/week @ 2022-11-03 8/week @ 2022-11-10 12/week @ 2022-11-17 11/week @ 2022-11-24

65 downloads per month
Used in below

Apache-2.0

645KB
14K SLoC

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)
  • snapshot subcommand to create a replayable snapshot file of historical system data

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

below is packaged in Fedora as of Fedora 34, and can be installed with:

sudo dnf install below

Optionally, the systemd service for persistent data collection can also be enabled with:

sudo systemctl enable --now below

Installing from source

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.

Dependencies

~14–21MB
~408K SLoC