Visualize Erlang/Elixir Nodes On The Command Line
Clone or download
Latest commit 12d2593 Sep 15, 2018


Build Status GitHub tag MIT License Version Downloads

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


  • 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.



%% rebar.config
{deps, [observer_cli]}
dep_observer_cli = hex 1.3.4


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


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@'
1> observer_cli:start('target@host', 'magic_cookie').
%% mix project
iex --name "observer_cli@" -S mix
iex(1)> :observer_cli.start(:'target@host', :'magic_cookie')

❗️ ensure observer_cli application been loaded on target node.


  1. cd path/to/observer_cli/
  2. 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.
  3. observer_cli TARGETNODE [TARGETCOOKIE REFRESHMS] to monitor remote node.


Home Network System Ets Mnesia Application Document Process Port


  • 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.


  • 1.3.4

    • View(ets mnesia) support page down/up; support sort by memory or size.
    • Fixed pause crash.
    • Make refresh interval configurable.
  • 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.




Dimitrios Zorbas




Trevor Brown


Zaiming Shi



See the LICENSE file for license rights and limitations (MIT).