Skip to content
/ erldash Public

A simple, terminal-based Erlang dashboard written in Rust

License

Notifications You must be signed in to change notification settings

sile/erldash

Repository files navigation

erldash

erldash Packaging status Actions Status License

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.

erldash demo

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.

About

A simple, terminal-based Erlang dashboard written in Rust

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages