# Erlang Performance Lab **URL:** \ **Category:** Discussions\ **Tags:** tools, beam, performance\ **Created:** [April 4, 2017, 9:36am UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456 "2017-04-04T09:36:48Z")\ **Posts on this page:** 17\ **Page:** 1
**Author:** ![arkgil](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/arkgil/32/14628_2.png) [@arkgil](https://forum.elixirforum.com/u/arkgil)\ **Post date:** [April 4, 2017, 9:36am UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/1 "2017-04-04T09:36:48Z")
Hello everyone! [Erlang Performance Lab](https://github.com/erlanglab/erlangpl) is a tool for developers working with the BEAM, which aims to help with analysis of performance and behaviour of their systems. Our goal is to provide a tool which will allow folks to see and understand what’s happening inside their systems at first few glances. That’s why we focus on visualising system’s behaviour rather than displaying raw debug information, which may be more detailed, but much harder to comprehend. We strive to make EPL useful for experienced developers, as well as people just getting into the BEAM world. Please note that it’s not meant to be a production-ready monitoring solution, but rather a debugging tool used in your day-to-day development. Currently our three main “views” are: - general node info, memory usage and processes count - visualisation of applications’ supervision trees - visualisation of network traffic between nodes in a cluster, and visualisation of message passing inside a single node And a little teaser: ![](https://forum.elixirforum.com/uploads/default/original/2X/4/48ec81265cb178826fa34e7d51f66f07b2b6f2bc.gif) ### Usage EPL is portable, meaning you only need Erlang installed on your machine. Then download our prebuilt escript and you’re good to go. You can find download link on [our website](http://www.erlang.pl/). To see what it’s all about, follow examples [in the README](https://github.com/erlanglab/erlangpl/blob/master/README.md). ### Contributing EPL is completely open-source, and we’d very much appreciate any kind of contributions, be it general usability feedback, finding bugs (😊), or developing new views and extending existing ones! We’re announcing it here today, because just 2 hours ago we merged a pull request, which allows development of backend plugins in Elixir! ### Resources - Michal Slaski’s talk on Erlang Performance Lab from EEF 2017 ([Youtube](https://www.youtube.com/watch?v=ncedupb-Rqw)) - [Github repository](https://github.com/erlanglab/erlangpl) - [Website](http://www.erlang.pl/) - You can follow our [Twitter account](https://twitter.com/erlanglab) If you have any questions regarding EPL, our vision, roadmap, favourite color, don’t hesitate to ask here or post an issue on Github. 🙂 ---
**Author:** ![OvermindDL1](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/overminddl1/32/2677_2.png) [@OvermindDL1](https://forum.elixirforum.com/u/OvermindDL1)\ **Post date:** [April 4, 2017, 3:43pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/2 "2017-04-04T15:43:56Z")
Ooo this looks fascinating! Thanks for the post! ---
**Author:** ![arkgil](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/arkgil/32/14628_2.png) [@arkgil](https://forum.elixirforum.com/u/arkgil)\ **Post date:** [April 4, 2017, 7:34pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/3 "2017-04-04T19:34:31Z")
I’m glad you like it 🙂 Have fun and break it! ---
**Author:** ![AstonJ](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/astonj/32/15_2.png) [@AstonJ](https://forum.elixirforum.com/u/AstonJ)\ **Post date:** [April 4, 2017, 7:35pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/4 "2017-04-04T19:35:54Z")
Looks great :023: ---
**Author:** ![aseigo](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/aseigo/32/10674_2.png) [@aseigo](https://forum.elixirforum.com/u/aseigo)\ **Post date:** [April 5, 2017, 9:39am UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/5 "2017-04-05T09:39:55Z")
I used this in a recent presentation on Elixir to show the clustering features in action … the eye-candy really grabbed people, and I’ll continue to monitor the project as it matures to provide further tools. Thanks to everyone who is working on this! Another interesting tool in this category that i found (and have also used in presentations 🙂 is [GitHub - koudelka/visualixir: A process/message visualizer for BEAM nodes.💪👁 · GitHub](https://github.com/koudelka/visualixir) ---
**Author:** ![arkgil](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/arkgil/32/14628_2.png) [@arkgil](https://forum.elixirforum.com/u/arkgil)\ **Post date:** [April 5, 2017, 10:07am UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/6 "2017-04-05T10:07:51Z")
Great to hear that you’ve already found it useful! We’re currently working on polishing existing views. Next on the roadmap are: - Drawing [flame graphs](http://www.brendangregg.com/flamegraphs.html) for the processes - Tracking messages received by the process, recording how they affect its state, and drawing it on a “timeline” ---
**Author:** ![jeramyRR](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/jeramyrr/32/722_2.png) [@jeramyRR](https://forum.elixirforum.com/u/jeramyRR)\ **Post date:** [April 5, 2017, 6:07pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/7 "2017-04-05T18:07:40Z")
Is EPL in coordination with Vizceral (Netflix), or is this something separate? ---
**Author:** ![OvermindDL1](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/overminddl1/32/2677_2.png) [@OvermindDL1](https://forum.elixirforum.com/u/OvermindDL1)\ **Post date:** [April 5, 2017, 7:58pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/8 "2017-04-05T19:58:02Z")
From: [erlangpl/README.md at master · erlanglab/erlangpl · GitHub](https://github.com/erlanglab/erlangpl/blob/master/README.md#getting-started) > It takes around 1 minute on stock MacBook 2015 plus dependencies download for the first time. Second time dependencies will be cached. I’m on a not at all low-end desktop (new, ‘high’-end work developer desktop, 4 cores, hyper-threading, 8gigs of ram, not as good as my home desktop but eh) and its been building for over 15 minutes now… The dots just keep spinning and spinning and spinning… Join me in the forever-spinning… ^.^ ![](https://forum.elixirforum.com/uploads/default/original/2X/1/1eec609752c03d667447d8b48e5e5b53516d3592.gif) But wow, that is a bit of a nasty build time on the front-end, maybe cache it in the github repo instead, or use a language that does not take forever to compile (\*cough\*elm\*cough\*)? 🙂 ---
**Author:** ![arkgil](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/arkgil/32/14628_2.png) [@arkgil](https://forum.elixirforum.com/u/arkgil)\ **Post date:** [April 5, 2017, 8:00pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/9 "2017-04-05T20:00:49Z")
Yes, we’re using Vizceral for cluster and message passing views. ---
**Author:** ![arkgil](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/arkgil/32/14628_2.png) [@arkgil](https://forum.elixirforum.com/u/arkgil)\ **Post date:** [April 5, 2017, 8:02pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/10 "2017-04-05T20:02:01Z")
That’s, wow, pretty long. Did you consider downloading our prebuilt escript? Or do you really want to compile it manually? Actually, we have complete setup for writing frontend code with Elm, so extending EPL with Elm is not a problem. ---
**Author:** ![OvermindDL1](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/overminddl1/32/2677_2.png) [@OvermindDL1](https://forum.elixirforum.com/u/OvermindDL1)\ **Post date:** [April 5, 2017, 8:09pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/11 "2017-04-05T20:09:43Z")
> [@arkgil](#): > > That’s, wow, pretty long. Did you consider downloading our prebuilt escript? Or do you really want to compile it manually? I was just following the instructions from top-to-bottom on the readme in the “Getting Started” section. It is still on that same screen as the animation, coming up on 30 minutes now (it took a few minutes to grab the animation and sync it). I cloned it into another directory too and tried the same thing, its doing the same thing. I’m not seeing instructions for curl’ing or mix installing the escript on the README.md, is it listed somewhere else? ---
**Author:** ![arkgil](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/arkgil/32/14628_2.png) [@arkgil](https://forum.elixirforum.com/u/arkgil)\ **Post date:** [April 5, 2017, 8:16pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/12 "2017-04-05T20:16:38Z")
Yes, you can find download link on our [webiste](http://www.erlang.pl/). I should’ve probably made first link in the post point to this page instead of a repository. Let me know if the package works for you 🙂 I’ll add download instructions to the README. ---
**Author:** ![OvermindDL1](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/overminddl1/32/2677_2.png) [@OvermindDL1](https://forum.elixirforum.com/u/OvermindDL1)\ **Post date:** [April 5, 2017, 8:36pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/13 "2017-04-05T20:36:54Z")
Heh, I never check the website for something when there is a github repo for it… ^.^; Got it, the escript works, the `make build-ui` was ‘still’ going so I killed it. Running it on my test server crashes a few seconds after it connects: ```elixir =ERROR REPORT==== 5-Apr-2017::14:26:45 === ** Generic server epl_st terminating ** Last message in was {data, {'devserver@127.0.0.1',{1491,424005,703000}}, [{process_count,337}, {memory_total,61696912}, {spawn,[]}, {exit,[]}, {send, [{{#Port<6777.19116>,<6777.421.0>},15,0}, {{#Port<6777.19117>,<6777.420.0>},15,0}, {{#Port<6777.19119>,<6777.419.0>},15,0}, {{#Port<6777.19120>,<6777.418.0>},15,0}, {{#Port<6777.19121>,<6777.417.0>},15,0}, {{#Port<6777.19123>,<6777.416.0>},15,0}, {{#Port<6777.19124>,<6777.415.0>},15,0}, {{#Port<6777.19126>,<6777.414.0>},15,0}, {{#Port<6777.19127>,<6777.413.0>},15,0}, {{#Port<6777.19128>,<6777.412.0>},15,0}, {{#Port<6777.23262>,<6777.567.0>},2,0}, {{<6777.45.0>,<6777.47.0>},0,1}, {{<6777.45.0>,<6777.567.0>},1,0}, {{<6777.567.0>,<6777.572.0>},1,0}]}, {send_self,[]}, {'receive', [{#Port<6777.19116>,10,130}, {#Port<6777.19117>,10,130}, {#Port<6777.19119>,10,130}, {#Port<6777.19120>,10,130}, {#Port<6777.19121>,10,130}, {#Port<6777.19123>,10,130}, {#Port<6777.19124>,10,130}, {#Port<6777.19126>,10,130}, {#Port<6777.19127>,10,130}, {#Port<6777.19128>,10,130}, {#Port<6777.23262>,2,24}, {<6777.45.0>,1,0}, {<6777.47.0>,1,0}, {<6777.274.0>,5,0}, {<6777.412.0>,15,75}, {<6777.413.0>,15,75}, {<6777.414.0>,15,75}, {<6777.415.0>,15,75}, {<6777.416.0>,15,75}, {<6777.417.0>,15,75}, {<6777.418.0>,15,75}, {<6777.419.0>,15,75}, {<6777.420.0>,15,75}, {<6777.421.0>,15,75}, {<6777.543.0>,3,0}, {<6777.546.0>,3,0}, {<6777.549.0>,4,0}, {<6777.567.0>,2,6}]}, {trace,[]}]} ** When Server state == {state,[]} ** Reason for termination == ** {function_clause, [{lists,map, [#Fun, {'EXIT', {{#{' __exception__' => true, ' __struct__' => 'Elixir.RuntimeError', message => <<"attempted to call GenServer :wobserver_metrics but no handle_call/3 clause was provided">>}, [{'Elixir.Agent.Server','handle_call (overridable 1)',3, [{file,"lib/gen_server.ex"},{line,559}]}, {gen_server,try_handle_call,4, [{file,"gen_server.erl"},{line,615}]}, {gen_server,handle_msg,5, [{file,"gen_server.erl"},{line,647}]}, {proc_lib,init_p_do_apply,3, [{file,"proc_lib.erl"},{line,247}]}]}, {gen_server,call,[<6777.404.0>,which_children,infinity]}}}], [{file,"lists.erl"},{line,1238}]}, {epl_st,generate_sup_tree,1,[{file,"src/epl_st.erl"},{line,105}]}, {epl_st,'-handle_info/2-fun-0-',2,[{file,"src/epl_st.erl"},{line,76}]}, {lists,foldl,3,[{file,"lists.erl"},{line,1263}]}, {epl_st,handle_info,2,[{file,"src/epl_st.erl"},{line,75}]}, {gen_server,try_dispatch,4,[{file,"gen_server.erl"},{line,601}]}, {gen_server,handle_msg,5,[{file,"gen_server.erl"},{line,667}]}, {proc_lib,init_p_do_apply,3,[{file,"proc_lib.erl"},{line,247}]}]} =INFO REPORT==== 5-Apr-2017::14:26:45 === application: epl_st exited: shutdown type: temporary ``` So apparently it crashes if the [wobserver](https://github.com/shinyscorpion/wobserver) is running on the remote node. Connecting it to a different test server seems to work, although as I’m clicking around on the supervisor tree page I get a few errors like: ```elixir =ERROR REPORT==== 5-Apr-2017::14:23:59 === ** Cowboy handler epl_st_EPL terminating in websocket_handle/3 for the reason error:badarg ** Message was {text,<<"<6777.435.0>">>} ** Options were [] ** Handler state was undefined_state ``` Quite pretty and responsive though! Any chance of some text labels on the supervisor tree graph? ---
**Author:** ![arkgil](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/arkgil/32/14628_2.png) [@arkgil](https://forum.elixirforum.com/u/arkgil)\ **Post date:** [April 5, 2017, 8:42pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/14 "2017-04-05T20:42:17Z")
Yes, we’re now focusing on extending existing views, including supervision trees. Can you create relevant issues in our repository? About errors you’ve encountered and functionality you’d like to see. I can’t promise we’ll be super fast with resolving those issues, but we’ll do our best 🙂 ---
**Author:** ![OvermindDL1](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/overminddl1/32/2677_2.png) [@OvermindDL1](https://forum.elixirforum.com/u/OvermindDL1)\ **Post date:** [April 5, 2017, 8:52pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/15 "2017-04-05T20:52:44Z")
> [@arkgil](#): > > Yes, we’re now focusing on extending existing views, including supervision trees. Can you create relevant issues in our repository? About errors you’ve encountered and functionality you’d like to see. > > I can’t promise we’ll be super fast with resolving those issues, but we’ll do our best 🙂 Reported, and no worry. 🙂 I’m not using wobserver on my big project due to its lack of security, and the little crashes did not seem to affect the usability in my quick testing, so all good. 🙂 ---
**Author:** ![jeroenvisser101](https://forum.elixirforum.com/user_avatar/forum.elixirforum.com/jeroenvisser101/32/25917_2.png) [@jeroenvisser101](https://forum.elixirforum.com/u/jeroenvisser101)\ **Post date:** [April 9, 2017, 1:46pm UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/16 "2017-04-09T13:46:40Z")
Since the usage and UI could be really similar to the visualisation tools for Kubernetes, you might want to have a look at [Weave Scope](https://cloud.weave.works/demo/), a visualisation tool for docker containers (inside a Kubernetes cluster). ---
**Author:** ![mkacper](https://forum.elixirforum.com/letter_avatar_proxy/v4/letter/m/ed655f/32.png) [@mkacper](https://forum.elixirforum.com/u/mkacper)\ **Post date:** [October 5, 2017, 8:21am UTC](https://forum.elixirforum.com/t/erlang-performance-lab/4456/17 "2017-10-05T08:21:01Z")
I’ve just published a blog post which presents an interesting ErlangPL use case. Here is the link: [https://medium.com/@mentel.kk/using-erlang-performance-lab-with-a-real-project-f101f39619c7](https://medium.com/@mentel.kk/using-erlang-performance-lab-with-a-real-project-f101f39619c7) I encourage you to read it! 🙂