glances-rs
6819ce4e18
- --fetch with a Jinja-subset renderer and the shipped templates - clippy clean, cargo fmt, all tests green - README status and differential testing instructions
glances-rs
A Rust rewrite of Glances, the system monitoring tool, targeting Linux.
This project is a drop-in replacement for the standalone Glances modes:
- curses-like terminal UI (
glances) - stdout modes:
--stdout,--stdout-csv,--stdout-json --fetch(with the shipped templates),--issue,--module-list- the same
glances.confconfiguration file (limits, thresholds, aliases, show/hide lists, per-plugin refresh, history, actions) - compatible stats schemas and CLI flags for the implemented features
The following Python Glances features are intentionally not provided: REST API, WebUI, MCP, client/server mode, discovery/browser, SNMP and exporters.
Status
| Area | Status |
|---|---|
| CLI (clap, drop-in flags) | done |
Configuration (glances.conf) |
done |
| Plugin model (limits, views, rates, MMM, history, events, actions) | done |
| Terminal UI (ratatui) | done |
| stdout / CSV / JSON / fetch / issue modes | done |
| Core plugins | cpu, percpu, mem, memswap, load, fs, network, diskio, sensors, irq, system, uptime, now, core, version, psutilversion, quicklook, processcount, processlist, programlist |
| Extended plugins | folders, amps, ports, raid, wifi, ip |
| Not ported yet | containers, vms, gpu/npu/mpp, connections, smart, cloud |
| Python-specific flags | --trace-malloc, --api-doc, --api-restful-doc rejected with a clear error |
Build and run
$ cargo build --release
$ ./target/release/glances # terminal UI
$ ./target/release/glances --stdout-json cpu,mem,load
$ ./target/release/glances --fetch
Differential testing
The tools/parity.py script compares the Rust implementation with the Python
reference implementation (the oracle) plugin by plugin: it runs both for a few
refreshes and diffs the flattened key sets and value types.
$ python3 -m venv /tmp/opencode/glances-py
$ /tmp/opencode/glances-py/bin/pip install /path/to/python-glances
$ cargo build
$ python3 tools/parity.py # all implemented plugins
$ python3 tools/parity.py cpu mem # selected plugins
Workspace layout
| Crate | Purpose |
|---|---|
glances-core |
plugin model, config, limits, history, events, filters, processes |
glances-plugins |
collectors, plugin registry and update engine |
glances-tui |
terminal UI (ratatui) |
glances-cli |
the glances binary, stdout modes and fetch renderer |
License
Licensed under either of Apache License, Version 2.0 or MIT license at your option.