{"id":13521919,"url":"https://github.com/facebookincubator/below","last_synced_at":"2025-05-13T16:10:45.667Z","repository":{"id":37482295,"uuid":"241722462","full_name":"facebookincubator/below","owner":"facebookincubator","description":"A time traveling resource monitor for modern Linux systems","archived":false,"fork":false,"pushed_at":"2025-04-15T20:21:03.000Z","size":4883,"stargazers_count":1346,"open_issues_count":18,"forks_count":67,"subscribers_count":36,"default_branch":"main","last_synced_at":"2025-04-23T20:56:26.454Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/facebookincubator.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-02-19T20:47:02.000Z","updated_at":"2025-04-22T16:25:50.000Z","dependencies_parsed_at":"2023-02-12T04:31:53.777Z","dependency_job_id":"9beaa90b-2429-4b06-800d-b8063a8fe3aa","html_url":"https://github.com/facebookincubator/below","commit_stats":{"total_commits":2338,"total_committers":165,"mean_commits":14.16969696969697,"dds":0.4880239520958084,"last_synced_commit":"d3b2107d65308ed9ed69a5a4ac25a30b4e6e88c4"},"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebookincubator%2Fbelow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebookincubator%2Fbelow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebookincubator%2Fbelow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/facebookincubator%2Fbelow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/facebookincubator","download_url":"https://codeload.github.com/facebookincubator/below/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250514767,"owners_count":21443208,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T06:00:39.560Z","updated_at":"2025-04-23T20:56:43.513Z","avatar_url":"https://github.com/facebookincubator.png","language":"Rust","readme":"\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003cimg width=300 src=\"https://github.com/facebookincubator/below/blob/main/img/below_logo_horizontal.png\" align=\"center\" alt=\"Below\" /\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cp\u003e\n    \u003ca href=\"https://matrix.to/#/#below:matrix.org\"\u003e\n      \u003cimg alt=\"Matrix chat\" src=\"https://img.shields.io/matrix/below:matrix.org\" /\u003e\n    \u003c/a\u003e\n    \u003ca href=\"https://github.com/facebookincubator/below/actions?query=workflow%3ACI+branch%3Amain+\"\u003e\n      \u003cimg alt=\"CI\" src=\"https://github.com/facebookincubator/below/workflows/CI/badge.svg\" /\u003e\n    \u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n`below` is an interactive tool to view and record historical system data. It\nhas support for:\n\n* information regarding hardware resource utilization\n* viewing the cgroup hierarchy\n* cgroup and process information\n* pressure stall information (PSI)\n* `record` mode to record system data\n* `replay` mode to replay historical system data\n* `live` mode to view live system data\n* `dump` subcommand to report script-friendly information (eg JSON, CSV, OpenMetrics, etc.)\n* `snapshot` subcommand to create a replayable snapshot file of historical system data\n\nbelow does **not** have support for cgroup1.\n\nThe name \"below\" stems from the fact that the below developers rejected many\nof [atop](https://linux.die.net/man/1/atop)'s design and style decisions.\n\n## Demo\n\n\u003ca href=\"https://asciinema.org/a/355506\"\u003e\n\u003cimg src=\"https://asciinema.org/a/355506.svg\" width=\"500\"\u003e\n\u003c/a\u003e\n\n## Installing\n\n### Fedora\n\n`below` is packaged in Fedora as of Fedora 34, and can be installed with:\n\n```shell\nsudo dnf install below\n```\n\nOptionally, the systemd service for persistent data collection can also be\nenabled with:\n\n```shell\nsudo systemctl enable --now below\n```\n\n### Alpine Linux\n\n`below` is packaged in Alpine Linux - it's available in (upcoming) v3.17+ and\nEdge. It can be installed with:\n\n```shell\nsudo apk add below\n```\n\nOptionally, the OpenRC service for persistent data collection can also be\nenabled with:\n\n```shell\nsudo rc-service below start\nsudo rc-update add below\n```\n\n### Gentoo Linux\n`below` is available in the\n[`sys-process/below`](https://packages.gentoo.org/packages/sys-process/below)\npackage and can be installed with `emerge`:\n\n```shell\nsudo emerge sys-process/below\n```\n\n## Installing from source\n\nFirst, install dependencies listed in [building.md](docs/building.md).\n\n```shell\n$ cargo install below\n$ below --help\n```\n\nFor convenience, we also provide a Dockerfile and\n[pre-built images](https://hub.docker.com/r/below/below) on Docker Hub.\nSee [docker.md](docs/docker.md) for how to use them.\n\n## Quickstart\n\nLive view of system:\n\n```shell\n$ sudo below live\n```\n\nRun recording daemon:\n\n```shell\n$ sudo cp ~/.cargo/bin/below /bin/below  # if using cargo-install\n$ sudo cp etc/below.service /etc/systemd/system\n$ sudo systemctl daemon-reload\n$ sudo systemctl start below\n```\n\nReplay historical data:\n\n```shell\n$ below replay -t \"3m ago\"\n```\n\n## Integration with Prometheus/Grafana\n\n`below` has basic support for Prometheus/Grafana through the `dump` interface.\n\nSee [contrib/grafana/](contrib/grafana) for more details.\n\n## Comparison with alternative tools\n\nSee [comparison.md](docs/comparison.md) for a feature comparison\nwith alternative tools.\n\n## Contributing\n\nSee the [CONTRIBUTING](CONTRIBUTING.md) file for how to help out.\n\n## License\n\nSee [LICENSE](LICENSE) file.\n","funding_links":[],"categories":["Monitoring","Rust","\u003ca name=\"monitoring\"\u003e\u003c/a\u003emonitoring","Tools \u0026 Observability","\u003ca name=\"monitor-top\"\u003e\u003c/a\u003eProcess viewers and monitoring (alternatives to top)","Table of Contents","System Monitor"],"sub_categories":["TOPs"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebookincubator%2Fbelow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffacebookincubator%2Fbelow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffacebookincubator%2Fbelow/lists"}