Vdash - dashboard for Autonomi nodes

happybeing · September 11, 2020, 4:51pm

vdash is a terminal based dashboard for monitoring Autonomi nodes on Windows, MacOS and Linux.

Selected keyboard commands:

press ‘enter’ to switch between Summary of Nodes and individual Node Status
press ‘?’ to see the Help with details of all keyboard commands
press ‘q’ to quit.

Update: vdash v0.19.x updated December 2024 (for Autonomi new network)

Screenshot shows v0.2.4

Install from crates.io

First install Rust as described in the README. For Windows only, you must also install the Visual Studio Redistributables as follows:

Got to Download Visual Studio Tools - Install Free for Windows, Mac, Linux
scroll down to “All Downloads” and click “Other Tools, Frameworks, and Redistributables”
click on “Build Tools for Visual Studio”
under “Microsoft Visual C++ Redistributable for Visual Studio” choose x64, ARM64 or x86
Click download and then run the VC ‘Redist’ installer

Once you have installed the above pre-requisites for your operating system:

cargo install vdash
vdash --help

Notes:

Caution: vdash should be fine with ~20 nodes but above 40 it might slow down or lock up and not be able to update numbers.
Windows: installation works on Windows 10 and 11
Linux: from Ubuntu 24 and other recent Debian based distros you can install directly from the package repository using sudo apt install safe-vdash. @jonas . A new version takes a few weeks to be updated there so be aware of that. You will always get the latest version from crates.io.

vdash can be used with Autonomi and community run networks and with your own local test networks.

For more, including how to use vdash with a local testnet please read the README.

Using vdash

With vdash you can see the node logfiles growing (like using tail -F) and can scroll up and down using the arrow keys. The display only shows one node at a time, but if you passed multiple logfiles to vdash you can cycle through them using TAB or the left/right arrow keys.

If you store some files with the CLI (e.g. safe files upload <directory>) eventually the PUTs will show up too. Same for GETs using safe cat and so on.

Collaborate (& Learn Rust If you like)

I don’t have much time for code now so happy for people to fork and chip in or take this forward yourself. I’ll help you learn along the way too when I have time.

To start, see how far you can get by forking the repo, building and setting up a development environment if you don’t have one yet. Then let me know what you’ve managed and anything you need help with.

github: GitHub - happybeing/vdash: A Dashboard for Autonomi Nodes that runs in the terminal
vdash chat: https://matrix.to/#/#vdash:matrix.org (once there you can sign-in or sign-up if you aren’t already).

Now with a Summary for all monitored nodes

In October 2023 I added a summary screen and new timelines. Here’s my vdash Summary for 20 nodes after 6 minutes of joining the HeapNet2 test network:

Southside · September 11, 2020, 6:28pm

THank you for this Mark, I just wish I had time right now to get tore into this properly

JPL · September 11, 2020, 8:34pm

Nice clear instructions in the README - I reckon even an idiot could get it working (famous last words). This one will have a go over the weekend.

JPL · September 13, 2020, 12:43pm

Works well on Linux (Mint) , with the delays noted in the OP (wonder why that is? Feels like it needs to be polling continuously but isn’t).

Two suggestions - make the name of the vault in Vault Status match the actual name of the vault being logged rather than just counting up from 1 - eg safe-vault-2 rather than vault 1. Also, it would be helpful if you could toggle word wrapping on and off in the Vault Log window.

Can’t build it in Windows though - have raised an issue on Github.

Look forward to future developments. Always happy to test stuff out with my limited abilities as you know, time permitting.

joshuef · September 13, 2020, 3:17pm

Looking forward to trying this tomorrow!

happybeing · September 13, 2020, 3:19pm

Excellent John, and thanks for the feedback and for raising issues.

I am about to push a simple timeline for PUTS and GETS, but that also needs quite a bit more work due to limitations of the graphics library. I’ll also need to provide multiple timescales.

There are lots of things I need to work on and the speed of processing is a priority because we now have some data to display but it is being updated far too slowly and is minutes behind real time even on a beefy processor.

I’ll bear your suggestions in mind, maybe when features are more complete I’ll be looking again at usability. Line wrap on the logfile window is possible but a biggish change so don’t expect that for a while.

So feel free to open issues for feature requests and UI enhancements too.

UPDATE: I’ve published a new version with a simple timeline for PUTS and GETS. Very crude work in progress, and not much use until I speed things up, but gives an idea of when this will be like.

davidpbrown · September 13, 2020, 3:36pm

I’ve no idea how you’re approaching this but wonder that an intermediate step that draws out the data and then the tail is a diff, might be faster than ever looking to read the whole of a large log file many times over. That said, I don’t know how you track the change… perhaps by line number if the log is not truncating itself.

happybeing · September 13, 2020, 3:39pm

Thanks @davidpbrown, the issue is within my processing, not accessing the files (which is handled by linemux). You can see this if you use logtail to monitor the files, it has no problem keeping up. Hopefully it won’t be hard to sort.

JPL · September 13, 2020, 9:02pm

All of my vault logs are static on Vdash, apart from one, Safe-Vault-2 which is updating about 10x a second. Why would that be I wonder?

happybeing · September 13, 2020, 9:06pm

Looks like you neglected to set the log level when starting your vaults:

And if you do cargo install vdash again (assuming that does what I expect it does) you will get a timeline!

JPL · September 13, 2020, 9:09pm

Hmm - pretty sure I did that. Let me try again.

happybeing · September 13, 2020, 9:11pm

Make sure you do safe vault killall and then manually delete all the existing logfiles first or you will still have a lot of guff in them. I should add that to the instructions, sorry! Done

JPL · September 13, 2020, 9:42pm

Yes working now. Maybe I did things in the wrong order. Loving the nostalgic graphics!

happybeing · September 13, 2020, 9:52pm

Great stuff John. I see you still have quinn filling up your logfile though so the RUST_LOG setting isn’t doing it’s job and it may cause problems. But at least you have seen the timeline working.

DeusNexus · September 13, 2020, 10:53pm

This sir is sexy.

happybeing · September 20, 2020, 4:46pm

Update: vdash is now at v0.2.2 ~~v0.2.0~~ to mark it becoming a bit useful. See the OP for latest screenshot) including timelines for PUTS, GETS and ERRORS.

i (zoom in) / o (zoom out) - zoom Timeline in or out. The +/i keys also zoom in/out over the following ranges: 1 second/minute/hour/day/week/year per column
left/right arrow - move to next/previous vault status
q - quit

happybeing · October 3, 2020, 5:02pm

Latest update has a few enhancements, tweaks and bugfixes.

Instructions to install on Linux/MacOS using cargo install, and for building on Windows can be found here.

If anyone if you have time to try a build on Windows, that would be cool. @JPL?

AFAIK nobody has tried this on MacOS yet, so if there are any brave Mac users out there, let me know what happens if you try it.

JPL · October 3, 2020, 7:06pm

Success! Had to add a flag --features="crossterm" though so

cargo +nightly build -Z features=itarget --bin vdash-crossterm --release --no-default-features --features="crossterm"

happybeing · October 3, 2020, 7:08pm

Thanks very much John. I’ll update the README.

JPL · October 4, 2020, 4:04pm

I’ve never had any success getting RUST_LOG=debug,quinn=error working on Windows. Probably a matter of them not being in the path but I’ve no idea where they live.