org.eclipse.linuxtools.lttng.help/Linux_Tools_Project/LTTng/User_Guide/User-Guide.html

   1 <?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   2 <html xmlns="http://www.w3.org/1999/xhtml">
   3         <head>
   4                 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
   5                 <title>LTTng Plug-in User Guide (legacy)</title>
   6                 <link type="text/css" rel="stylesheet" href="../../../book.css"/>
   7         </head>
   8         <body>
   9                 <table class="navigation" style="width: 100%;" border="0" summary="navigation">
  10                         <tr>
  11                                 <th style="width: 100%" align="center" colspan="3">LTTng Plug-in User Guide (legacy)</th>
  12                         </tr>
  13                         <tr>
  14                                 <td style="width: 20%" align="left"></td>
  15                                 <td style="width: 60%" align="center"></td>
  16                                 <td style="width: 20%" align="right">
  17                                         <a href="Getting-Started.html" title="Getting Started">
  18                                                 <img alt="Next" border="0" src="../../../images/next.gif"/>
  19                                         </a>
  20                                 </td>
  21                         </tr>
  22                         <tr>
  23                                 <td style="width: 20%" align="left" valign="top"></td>
  24                                 <td style="width: 60%" align="center"></td>
  25                                 <td style="width: 20%" align="right" valign="top">Getting Started</td>
  26                         </tr>
  27                 </table><hr/>
  28                 <h1 id="Introduction">Introduction</h1>
  29                 <p>LTTng 2.0 (Linux Trace Toolkit, next generation 2.0) is a highly efficient tracing tool for Linux that can be used to track down kernel and application performance issues as well as debug problems involving multiple concurrent processes and threads. It consists of a set of kernel modules, a daemon - to collect the raw tracing data - and a set of tools to control, visualize and analyze the generated data.</p>
  30                 <p>The LTTng plug-in for Eclipse provides an Eclipse integration for the control, fetching and visualization of LTTng traces. It also provides the foundation for user-defined analysis tools.</p>
  31                 <p>At present, the LTTng Eclipse plug-in for Eclipse supports the following kernel-oriented analyses:</p>
  32                 <ul>
  33                         <li>
  34                                 <i>Control Flow</i> - to visualize processes state transition
  35                         </li>
  36                         <li>
  37                                 <i>Resources</i> - to visualize system resources state transitions
  38                         </li>
  39                         <li>
  40                                 <i>Statistics</i> - to provide simple statistics on event occurences
  41                         </li>
  42                 </ul>
  43                 <p>For more information about LTTng, refer to the project
  44                         <a href="http://lttng.org">site</a>
  45                 </p>
  46                 <h2 id="About_Tracing">About Tracing</h2>
  47                 <p>Tracing is a troubleshooting technique used to understand the behavior of an instrumented application by collecting information on its execution path. A tracer is the software used for tracing. Tracing can be used to debug a wide range of bugs that are otherwise extremely challenging. These include, for example, performance problems in complex parallel systems or real-time systems.</p>
  48                 <p>Tracing is similar to logging: it consists in recording events that happen in a system at selected execution locations. However, compared to logging, it is generally aimed at developers and it usually records low-level events at a high rate. Tracers can typically generate thousands of events per second. The generated traces can easily contain millions of events and have sizes from many megabytes to tens of gigabytes. Tracers must therefore be optimized to handle a lot of data while having a small impact on the system.</p>
  49                 <p>Traces may include events from the operating system kernel (IRQ handler entry/exit, system call entry/exit, scheduling activity, network activity, etc). They can also consists of application events (a.k.a UST - User Space Tracing) or a mix of the two.</p>
  50                 <p>For the maximum level of detail, tracing events may be viewed like a log file. However, trace analyzers and viewers are available to produce useful information from the raw data. These programs must be specially designed to handle quickly the enormous amount of data a trace may contain.</p>
  51                 <p>In the case of LTTng, low tracing overhead is achieved by instrumenting the Linux kernel with a set of custom patches. The same set of patches can be used for tracing both the Linux kernel and user applications (UST).</p>
  52                 <h2 id="Traces_and_Experiments">Traces and Experiments</h2>
  53                 <p>In the scope of the LTTng plug-in for Eclipse, a trace is essentially a set of time-ordered LTTng events. The LTTng application can read these traces and provide a number of standard views to analyze their contents.</p>
  54                 <p>An experiment consists in an arbitrary number of aggregated LTTng traces for purpose of correlation. In the degenerate case, an experiment can consist of a single trace.</p>
  55                 <p>The experiment provides a unified, time-ordered stream of the individual LTTng trace events.</p><hr/>
  56                 <table class="navigation" style="width: 100%;" border="0" summary="navigation">
  57                         <tr>
  58                                 <td style="width: 20%" align="left"></td>
  59                                 <td style="width: 60%" align="center"></td>
  60                                 <td style="width: 20%" align="right">
  61                                         <a href="Getting-Started.html" title="Getting Started">
  62                                                 <img alt="Next" border="0" src="../../../images/next.gif"/>
  63                                         </a>
  64                                 </td>
  65                         </tr>
  66                         <tr>
  67                                 <td style="width: 20%" align="left" valign="top"></td>
  68                                 <td style="width: 60%" align="center"></td>
  69                                 <td style="width: 20%" align="right" valign="top">Getting Started</td>
  70                         </tr>
  71                 </table>
  72         </body>
  73 </html>