observer_cli

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

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

Elixir

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

How-To

Try in local shell.

rebar3 shell
1> observer_cli:start().

Monitor remote node

rebar3 shell --name 'observer_cli@127.0.0.1'
1> observer_cli:start('target@host', 'magic_cookie').

❗ ensure observer_cli application start on target node.

Escriptize

1. 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.
2. 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.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.

Contributors

zhongwencool 💻	Dimitrios Zorbas 💻	taotao 💻	Trevor Brown 💻

License

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