vdash is a terminal based dashboard for monitoring Safe Vaults
I’ve not yet added a timeline but vdash is now at a stage where it might be useful for those playing with a local network.
Windows, Mac, Linux
AFAIK it works on Linux, possible Mac but you need to build as described for logtail-dash if you want to run on Windows.
Install from crates.io
See the README for more, but assuming you have Rust installed:
cargo install vdash vdash --help
That should work but I confess I haven’t tested it.
Use with a local test network
safe vault killall rm -f ~/.safe/vault/baby-fleming-vaults/*/safe_vault.log RUST_LOG=debug,quinn=error safe vault run-baby-fleming -t
- you need to make sure no existing vaults are still running, and deleting existing logfiles prevents you picking up statistics from previous activity.
- setting RUST_LOG ensures the logfiles contain the data which
vdashneeds, and excludes some that gets in the way.
For more info see the README which walks you through everything.
vdash you’ll see the vault logfiles growing (like using
tail -f) and can scroll up and down using the arrow keys. The display only shows one vault at a time, but if you passed multiple logfiles to
vdash you can cycle through them using TAB or the left/right arrow keys.
You’ll see the vault ages move fairly rapidly from Infant to Elder, and if you store some files with the Safe CLI (e.g.
safe files put -r <directory>) eventually the PUTs will show up too. Same for gets using
safe cat and so on.
NOTE: Vault Metrics and Timeline are not implemented yet and will remain blank.
For some reason it takes a while for the PUT and GET counts to show in the “Vault Status” window (top left). I’m not sure why this is and haven’t investigated yet, but they will show up eventually!
Let me know if you have a go and how you get on.
PS There’s a known bug where after some time
vdash stops getting the updates to tell it the vault files have changed. I may have a fix for this but for now you can just restart
vdash if this happens.