Awesome
erldash
A simple, terminal-based Erlang dashboard.
erldash
connects to an Erlang node using the dynamic node name feature (since OTP-23) to collect metrics.
It only depends on erlang
and erpc
modules.
So you can use this dashboard out of the box without installing any additional packages to the target Erlang node.
Metrics are collected using erlang:statistics/1
, erlang:memory/0
and erlang:system_info/1
functions.
Installation
Pre-built binaries
Pre-built binaries for Linux and MacOS are available in the releases page.
// An example to download the binary for Linux.
$ VERSION=... # Set the target erldash version such as "0.2.0"
$ curl -L https://github.com/sile/erldash/releases/download/${VERSION}/erldash-${VERSION}.x86_64-unknown-linux-musl -o erldash
$ chmod +x erldash
$ ./erldash
With Cargo
If you have installed cargo
(the package manager for Rust), you can install erldash
with the following command:
$ cargo install erldash
$ erldash
Note that you need to use Rust-v1.58.0 or later to build erldash
.
Usage
Just execute the following command:
$ erldash run $TARGET_ERLANG_NODE
If you need to specify a cookie value other than $HOME/.erlang.cookie
, please specify that to --cookie
option.
$ erldash --help
shows the detailed help message.
You can record the collected metrics to a file via --record <FILE>
option and replay the recorded run using $ erldash replay <FILE>
command.