observer_cli

Visualize Erlang/Elixir Nodes On The Command Line base on recon. Document in detail.

Goal

Provide a high-performance tool usable both in development and production settings.
Focus on important and detailed information about real-time running system.
Keep minimal consumption.

Installation

Erlang

%% rebar.config
{deps, [observer_cli]}
%% erlang.mk
dep_observer_cli = hex 1.3.1

Elixir

# mix.exs                                                                                                   
   def deps do                                                          
     [{:observer_cli, "~> 1.3"}]
   end

How-To

Try in local shell.

%% rebar3 project
rebar3 shell
1> observer_cli:start().
%% mix project
iex -S mix
iex(1)> :observer_cli.start

Monitor remote node

%% rebar3 project
rebar3 shell --name 'observer_cli@127.0.0.1'
1> observer_cli:start('target@host', 'magic_cookie').
%% mix project
iex --name "observer_cli@127.0.0.1" -S mix
iex(1)> :observer_cli.start(:'target@host', :'magic_cookie')

❗ ensure observer_cli application been loaded on target node.

Escriptize

cd path/to/observer_cli/
rebar3 escriptize to generate an escript executable containing the project's and its dependencies' BEAM files. Place script(_build/default/bin/observer_cli) anywhere in your path and use observer_cli command.
observer_cli TARGETNODE [TARGETCOOKIE] to monitor remote node.

GUI

TODO

Processes Memory, Binary, Total Heap Size, Reductions Top.
include System and Architecture, CPU's and Threads metrics in observer's system
Memory Allocators: std, ll, eheap, ets,fix, binary, driver.
ets include all metrics ets in observer's Table Viewer.
doc (keep simple)
remote node support
mneisa: table info by using mnesia:info, mnesia:system_info/1,
~~Draw all application’s relations.~~
~~Trace Overview.~~ You should use recon_trace.

Changelog

1.3.3
- fixed io:format(Format,Args) Format not support iolist OTP R21
1.3.2
- Make sure all observer_cli process exit when quit.
- Upgrade recon to 2.3.6
1.3.1
- Add atom limit/count in home.
- Escript support short name and long name.
- Fixed store process not exit.
- Upgrade recon to 2.3.5
1.3.0
- Rewrite Network/Process view.
- Support PageDown/PageUp for top n list.
- Escript auto load observer_cli when it's not load on target node.
1.2.2
- fix schedule number >= 32 display wrong.
- improve memory(byte/kilobyte/megabyte/gigabyte) unit.
1.2.1
- fixed autosize not work.
- try best to make color adjust all platform.
1.2.0
- add application GUI.
- Rearrange GUI and optimize render.
- Always automatically adapt to the window size.
1.1.0
- Support escript, observer_cli <TARGETNODE> <COOKIE>
1.0.9
- Upgrade rebar3 to 3.3.3 for publish hex repo.