<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html xmlns:fn="http://www.w3.org/2005/02/xpath-functions"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" href="../../../../doc/otp_doc.css" type="text/css"> <title>Erlang -- Introduction</title> </head> <body bgcolor="white" text="#000000" link="#0000ff" vlink="#ff00ff" alink="#ff0000"><div id="container"> <script id="js" type="text/javascript" language="JavaScript" src="../../../../doc/js/flipmenu/flipmenu.js"></script><script id="js2" type="text/javascript" src="../../../../doc/js/erlresolvelinks.js"></script><script language="JavaScript" type="text/javascript"> <!-- function getWinHeight() { var myHeight = 0; if( typeof( window.innerHeight ) == 'number' ) { //Non-IE myHeight = window.innerHeight; } else if( document.documentElement && ( document.documentElement.clientWidth || document.documentElement.clientHeight ) ) { //IE 6+ in 'standards compliant mode' myHeight = document.documentElement.clientHeight; } else if( document.body && ( document.body.clientWidth || document.body.clientHeight ) ) { //IE 4 compatible myHeight = document.body.clientHeight; } return myHeight; } function setscrollpos() { var objf=document.getElementById('loadscrollpos'); document.getElementById("leftnav").scrollTop = objf.offsetTop - getWinHeight()/2; } function addEvent(obj, evType, fn){ if (obj.addEventListener){ obj.addEventListener(evType, fn, true); return true; } else if (obj.attachEvent){ var r = obj.attachEvent("on"+evType, fn); return r; } else { return false; } } addEvent(window, 'load', setscrollpos); //--></script><div id="leftnav"><div class="innertube"> <img alt="Erlang logo" src="../../../../doc/erlang-logo.png"><br><small><a href="users_guide.html">User's Guide</a><br><a href="index.html">Reference Manual</a><br><a href="release_notes.html">Release Notes</a><br><a href="../pdf/et-1.4.pdf">PDF</a><br><a href="../../../../doc/index.html">Top</a></small><p><strong>Event Tracer (ET)</strong><br><strong>User's Guide</strong><br><small>Version 1.4</small></p> <br><a href="javascript:openAllFlips()">Expand All</a><br><a href="javascript:closeAllFlips()">Contract All</a><p><small><strong>Chapters</strong></small></p> <ul class="flipMenu" imagepath="../../../../doc/js/flipmenu"> <li id="loadscrollpos" title="Introduction" expanded="true">Introduction<ul> <li><a href="et_intro.html"> Top of chapter </a></li> <li title="Scope and Purpose"><a href="et_intro.html#id2254485">Scope and Purpose</a></li> <li title="Prerequisites"><a href="et_intro.html#id2261326">Prerequisites</a></li> <li title="About This Manual"><a href="et_intro.html#id2252946">About This Manual</a></li> <li title="Where to Find More Information"><a href="et_intro.html#id2252914">Where to Find More Information</a></li> </ul> </li> <li id="no" title="Tutorial" expanded="false">Tutorial<ul> <li><a href=".html"> Top of chapter </a></li> <li title="Visualizing Message Sequence Charts"><a href=".html#id2259993">Visualizing Message Sequence Charts</a></li> <li title="Four Modules"><a href=".html#id2252987">Four Modules</a></li> <li title="The Event Tracer Interface"><a href=".html#id2252733">The Event Tracer Interface</a></li> <li title="The Collector and Viewer"><a href=".html#id2253015">The Collector and Viewer</a></li> <li title="The Selector"><a href=".html#id2253543">The Selector</a></li> <li title="How To Put It Together"><a href=".html#id2252268">How To Put It Together</a></li> </ul> </li> <li id="no" title="Description" expanded="false">Description<ul> <li><a href="et_desc.html"> Top of chapter </a></li> <li title="Overview"><a href="et_desc.html#id2259801">Overview</a></li> <li title="Filters and dictionary"><a href="et_desc.html#id2252158">Filters and dictionary</a></li> <li title="Trace clients"><a href="et_desc.html#id2262283">Trace clients</a></li> <li title="Global tracing"><a href="et_desc.html#id2261856">Global tracing</a></li> <li title="Viewer window"><a href="et_desc.html#id2262017">Viewer window</a></li> <li title="Configuration"><a href="et_desc.html#id2260863">Configuration</a></li> <li title="Contents viewer window"><a href="et_desc.html#id2260898">Contents viewer window</a></li> </ul> </li> <li id="no" title="Advanced examples" expanded="false">Advanced examples<ul> <li><a href="et_examples.html"> Top of chapter </a></li> <li title="A simulated Mnesia transaction"><a href="et_examples.html#id2261189">A simulated Mnesia transaction</a></li> <li title="Some convenient functions used in the Mnesia transaction example"><a href="et_examples.html#id2262408">Some convenient functions used in the Mnesia transaction example</a></li> <li title="Erlang trace of a real Mnesia transaction"><a href="et_examples.html#id2262595">Erlang trace of a real Mnesia transaction</a></li> <li title="Erlang trace of Megaco startup"><a href="et_examples.html#id2262738">Erlang trace of Megaco startup</a></li> </ul> </li> </ul> </div></div> <div id="content"> <div class="innertube"> <h1>1 Introduction</h1> <p>The <span class="code">Event Tracer (ET)</span> uses the built-in trace mechanism in Erlang and provides tools for collection and graphical viewing of trace data.</p> <p>The viewed trace data is normally collected from Erlang trace ports or files.</p> <h3><a name="id2254485">1.1 Scope and Purpose</a></h3> ' <p>This manual describes the <span class="code">Event Tracer (ET)</span> application, as a component of the Erlang/Open Telecom Platform development environment. It is assumed that the reader is familiar with the Erlang Development Environment, which is described in a separate User's Guide.</p> <h3><a name="id2261326">1.2 Prerequisites</a></h3> <p>The following prerequisites is required for understanding the material in the <span class="code">Event Tracer (ET)</span> User's Guide:</p> <ul> <li> <p>familiarity with the Erlang system and Erlang programming in general and the especially the art of Erlang tracing.</p> </li> </ul> <p>The application requires Erlang/OTP release R13BB or later. If you use the old <span class="code">GS</span> based GUI it does suffice with R7B.</p> <h3><a name="id2252946">1.3 About This Manual</a></h3> <p>In addition to this introductory chapter, the <span class="code">Event Tracers</span> User's Guide contains the following chapters:</p> <ul> <li> <p>Chapter 2: "Tutorial" provides a walk-through of the various parts of the application. The tutorial is based on <span class="code">Jayson Vantuyl's</span> article <span class="code">http://souja.net/2009/04/making-sense-of-erlangs-event-tracer.html</span>.</p> </li> <li> <p>Chapter 3: "Description" describes the architecture and typical usage of the application.</p> </li> <li> <p>Chapter 4: "Advanced examples" gives some usage examples</p> </li> </ul> <h3><a name="id2252914">1.4 Where to Find More Information</a></h3> <p>Refer to the following documentation for more information about <span class="code">Event Tracer (ET)</span> and about the Erlang/OTP development system:</p> <ul> <li> <p>the Reference Manual of the <span class="code">Event Tracer (ET)</span>.</p> </li> <li> <p>documentation of basic tracing in <span class="code">erlang:trace/4</span> and <span class="code">erlang:trace_pattern/3</span> and then the utilities derived from these: <span class="code">dbg</span>, <span class="code">observer</span>, <span class="code">invisio</span> and <span class="code">et</span>.</p> </li> <li> <p>Programming Erlang: Software for a Concurrent World by Joe Armstrong; ISBN: 978-1-93435-600-5</p> </li> </ul> </div> <div class="footer"> <hr> <p>Copyright © 2002-2010 Ericsson AB. All Rights Reserved.</p> </div> </div> </div></body> </html>