If you can't beat them, join them.
Measure how much resources your experiment actually gets, and who is stealing it from you.
Features
Gain confidence about the conditions and comparability of your experiments.
Auto-detect your experiment runs
- Set regex filter and find all processes related to your experment.
- Monitor how server resource conditions change for each run and qunatify how much each run gets affected.
Clear and interpretable metrics
- Congestion Score: CPU, Mem and I/O pressure in one value.
- Sched. wait How long a process is queued vs. run.
- Focusing only on the cores your experiments actually runs on.
Debug what slows you down
See at a glance what's the bottleneck (CPU, Mem, I/O) and how much they contribute to congestion.
Who is slowing you down
- Find out which of your runs got affected the most.
- Find out which users or processes contribute how much to the slowdown.
LaTeX paper-ready export
Export a statistics table and report template that quantifies the server environment and fairness of resources over all your experiments.
Detach & reattach
The daemon keeps recording in the background. Close the TUI, come back later, attach again.
| What it's not | What it is |
|---|---|
|
|
Install
Written in rust, no runtime dependencies, installable on user-level without sudo.
Quick install
$ curl -fsSL https://raw.githubusercontent.com/lennart-rth/server-spy/master/install.sh | sh
| Platform | Command | Details |
|---|---|---|
| Debian / Ubuntu | curl -fsSL https://lennart-rth.github.io/server-spy/install-apt.sh | sudo sh | apt repository |
| Nix / NixOS | nix run github:lennart-rth/server-spy | |
| Fedora / RHEL | rpm -Uvh server-spy-<ver>-1.x86_64.rpm | download from GitHub releases |
| crates.io | cargo install server-spy | |
| static binary | server-spy-<ver>-x86_64-unknown-linux-musl.tar.gz | download from GitHub releases |
- Select your experiment processes - press
f, to filter for your experiment runs using regex or simple matching. - Monitor - Watch who and what is slowing down your experiments.
- Detach - Detach the TUI. server-spy continues to collect the data in the background. You can connect again any time.
- Save/Export - Save as CSV report or export LaTeX ready tables and templates directly.
| f | update the worker filter (with live preview) |
| s / l | save / load snapshots to disk |
| q | terminate - stop the background daemon and exit |
| d | detach - exit, the daemon keeps recording |
| r | restart recording |
| t | stealth mode - rename the processes so ps/top show something innocuous for others |