Repository files navigation

below is an interactive tool to view and record historical system data. Ithas 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, CSV, OpenMetrics, etc.)
• snapshot subcommand to create a replayable snapshot file of historical system data

below doesnot have support for cgroup1.

The name "below" stems from the fact that the below developers rejected manyofatop's design and style decisions.

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 beenabled with:

sudo systemctlenable --now below

below is packaged in Alpine Linux - it's available in (upcoming) v3.17+ andEdge. It can be installed with:

sudo apk add below

Optionally, the OpenRC service for persistent data collection can also beenabled with:

sudo rc-service below startsudo rc-update add below

below is available in thesys-process/belowpackage and can be installed withemerge:

sudo emerge sys-process/below

First, install dependencies listed inbuilding.md.

$ cargo install below$ below --help

For convenience, we also provide a Dockerfile andpre-built images on Docker Hub.Seedocker.md for how to use them.

Live view of system:

$ sudo below live

Run recording daemon:

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

Replay historical data:

$ below replay -t"3m ago"

below has basic support for Prometheus/Grafana through thedump interface.

Seecontrib/grafana/ for more details.

Seecomparison.md for a feature comparisonwith alternative tools.

See theCONTRIBUTING file for how to help out.

SeeLICENSE file.