Fix test cases to use time zone offsets
[deliverable/tracecompass.git] / org.eclipse.linuxtools.lttng.help / Linux_Tools_Project / LTTng / User_Guide / LTTng-Perspective.html
CommitLineData
70f06a6f
FC
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"/>
6dc1ef9f 5 <title>LTTng Plug-in User Guide (legacy) - LTTng Perspective</title>
70f06a6f
FC
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>
f01efa62 11 <th style="width: 100%" align="center" colspan="3">LTTng Perspective</th>
70f06a6f
FC
12 </tr>
13 <tr>
14 <td style="width: 20%" align="left">
15 <a href="Getting-Started.html" title="Getting Started">
16 <img alt="Previous" border="0" src="../../../images/prev.gif"/>
17 </a>
18 </td>
19 <td style="width: 60%" align="center"></td>
20 <td style="width: 20%" align="right">
1507e5df 21 <a href="LTTng-Tracer-Control.html" title="LTTng Tracer Control">
70f06a6f
FC
22 <img alt="Next" border="0" src="../../../images/next.gif"/>
23 </a>
24 </td>
25 </tr>
26 <tr>
27 <td style="width: 20%" align="left" valign="top">Getting Started</td>
28 <td style="width: 60%" align="center"></td>
1507e5df 29 <td style="width: 20%" align="right" valign="top">LTTng Tracer Control</td>
70f06a6f
FC
30 </tr>
31 </table><hr/>
f01efa62 32 <h1 id="LTTng_Perspective">LTTng Perspective</h1>
70f06a6f
FC
33 <p>The LTTng perspective groups the LTTng specific views, namely:</p>
34 <ul>
35 <li>
f01efa62
FC
36 <a href="LTTng-Perspective.html#Project_View">Project View</a>
37 </li>
38 <li>
216eaac0 39 <a href="LTTng-Perspective.html#Events_View">Events View</a>
70f06a6f
FC
40 </li>
41 <li>
f01efa62 42 <a href="LTTng-Perspective.html#Histogram_View">Histogram View</a>
70f06a6f
FC
43 </li>
44 <li>
f01efa62 45 <a href="LTTng-Perspective.html#Control_Flow_View">Control Flow View</a>
70f06a6f
FC
46 </li>
47 <li>
f01efa62 48 <a href="LTTng-Perspective.html#Resources_View">Resources View</a>
70f06a6f
FC
49 </li>
50 <li>
f01efa62 51 <a href="LTTng-Perspective.html#Statistics_View">Statistics View</a>
70f06a6f
FC
52 </li>
53 <li>
f01efa62 54 <a href="LTTng-Perspective.html#Latency_View">Latency View</a>
70f06a6f
FC
55 </li>
56 </ul>
57 <p>The views are synchronized i.e. selecting an event, a timestamp, a time range, etc will update the other views accordingly.</p>
58 <p>
59 <img border="0" src="images/LTTngPerspective.png"/>
60 </p>
61 <p>The perspective can be opened from the Eclipse Open Perspective dialog (Window &gt; Open Perspective... &gt; Other).</p>
62 <p>
63 <img border="0" src="images/LTTngPerspectiveOpen.png"/>
64 </p>
f01efa62
FC
65 <h2 id="Project_View">Project View</h2>
66 <p>The project view is the standard Eclipse Project Explorer. LTTng being a tracing project, it is shown with a small "T" decorator in the upper right of the project folder icon.</p>
70f06a6f 67 <p>
f01efa62
FC
68 <img border="0" src="images/ProjectExplorer.png"/>
69 </p>
70 <p>Tracing projects have two sub-folders:
71 <b>Traces</b> which holds the individual traces, and
72 <b>Experiments</b> which holds sets of traces that we want to correlate.
70f06a6f 73 </p>
f01efa62 74 <h3 id="Creating_a_Project">Creating a Project</h3>
70f06a6f
FC
75 <p>A new LTTng project can be created using the LTTng Project dialog (File &gt; New &gt; Project... or the context menu)</p>
76 <p>
77 <img border="0" src="images/LTTngProjectNewWizard.png"/>
78 </p>
79 <p>
80 <img border="0" src="images/LTTngProjectNewDialog.png"/>
81 </p>
f01efa62
FC
82 <p>At this point, you can press Finish and complete the project creation or you can press Next to provide a project-specific parser library path.</p>
83 <p>
84 <img border="0" src="images/LTTngProjectNewDialog-2.png"/>
85 </p>
86 <p>Once the project is created, you can modify the parser library path at any time by selecting the project's property page (right-click on the project, Properties).</p>
87 <p>
88 <img border="0" src="images/LTTngProjectProperty.png"/>
89 </p>
90 <h3 id="Importing_Traces_in_a_Project">Importing Traces in a Project</h3>
70f06a6f
FC
91 <p>The Traces folder holds the set of traces available for experiments. Traces are imported in the LTTng project using an import wizard triggered by a context menu.</p>
92 <p>Note: An LTTng trace is actually a composite of multiple channel traces grouped under a folder. It is the folder that has to be imported. </p>
93 <p>
94 <img border="0" src="images/LTTngTraceImportDialog.png"/>
95 </p>
96 <p>The Experiment folder holds the set of experiments of the project. Experiments are created from the Experiment context menu and are configured from the experiment's context menu.</p>
97 <p>
98 <img border="0" src="images/LTTngTraceSelectDialog.png"/>
99 </p>
1507e5df
BH
100 <h3 id="Drag_and_Drop">Drag and Drop</h3>
101 <p>Traces can be also be imported to a project by dragging from another tracing project and dropping to the project's trace folder. The trace will be copied and the trace type will be set.</p>
102 <p>Any resource can be dragged and dropped from a non-tracing project, and any file or folder can be dragged from an external tool, into a tracing project's trace folder. The resource will be copied or imported as a new trace, however the trace type will be unknown and need to be set manually by the user.</p>
103 <p>It is also possible to drop a trace, resource, file or folder into an existing experiment. If the item does not already exist as a trace in the project's trace folder, it will first be copied or imported, then the trace will be added to the experiment.</p>
216eaac0
BH
104 <h2 id="Events_View">Events View</h2>
105 <p>The Events view shows the basic trace data in chronological order in a tabular format.</p>
1507e5df 106 <p>When opened, the Events view displays the events of the currently selected trace or experiment.</p>
70f06a6f
FC
107 <p>The header displays the current trace (or experiment) name. The table displays the following fields:</p>
108 <ul>
109 <li>
110 <b>Timestamp</b>: the event timestamp
111 </li>
112 <li>
1507e5df 113 <b>Trace</b>: the trace that holds the event (e.g. experiments typically hold multiple traces)
70f06a6f
FC
114 </li>
115 <li>
1507e5df 116 <b>Marker</b>: the event type and localization
70f06a6f
FC
117 </li>
118 <li>
119 <b>Content</b>: the raw event content
120 </li>
121 </ul>
cfbde3ef 122 <p>The first row of the table is the header row a.k.a. the Search and Filter row.</p>
70f06a6f 123 <p>
216eaac0 124 <img border="0" src="images/EventsView.png"/>
70f06a6f
FC
125 </p>
126 <p>The highlighted event is the
127 <i>current event</i> and is synchronized with the other views. If you select another event, the other views will be synchronized accordingly.
128 </p>
f01efa62 129 <h3 id="Searching_and_Filtering">Searching and Filtering</h3>
cfbde3ef
FC
130 <p>Searching and filtering of events in the table can be performed by entering matching conditions in one or multiple columns in the header row (the first row below the column header).</p>
131 <p>To toggle between searching and filtering, click on the 'search' (
132 <img border="0" src="images/TmfEventSearch.gif"/>) or 'filter' (
133 <img border="0" src="images/TmfEventFilter.gif"/>) icon in the header row's left margin, or right-click on the header row and select
134 <b>Show Filter Bar</b> or
135 <b>Show Search Bar</b> in the context menu.
136 </p>
137 <p>To apply a matching condition to a specific column, click on the column's header row cell, type in a
138 <a href="http://download.oracle.com/javase/7/docs/api/java/util/regex/Pattern.html">regular expression</a> and press the
139 <b>ENTER</b> key. You can also enter a simple text string and it will be automatically be replaced with a 'contains' regular expression.
140 </p>
141 <p>When matching conditions are applied to two or more columns, all conditions must be met for the event to match (i.e. 'and' behavior).</p>
142 <p>To clear all matching conditions in the header row, press the
143 <b>DEL</b> key.
144 </p>
f01efa62 145 <h4 id="Searching">Searching</h4>
cfbde3ef
FC
146 <p>When a searching condition is applied to the header row, the table will select the next matching event starting from the top currently displayed event. Wrapping will occur if there is no match until the end of the trace.</p>
147 <p>All matching events will have a 'search match' icon in their left margin. Non-matching events will be dimmed.</p>
148 <p>
149 <img border="0" src="images/TmfEvents-Search.png"/>
150 </p>
151 <p>Pressing the
152 <b>ENTER</b> key will search and select the next matching event. Pressing the
153 <b>SHIFT-ENTER</b> key will search and select the previous matching event. Wrapping will occur in both directions.
154 </p>
155 <p>Press
156 <b>ESC</b> to cancel an ongoing search.
157 </p>
158 <p>Press
159 <b>DEL</b> to clear the header row and reset all events to normal.
160 </p>
f01efa62 161 <h4 id="Filtering">Filtering</h4>
cfbde3ef
FC
162 <p>When a filtering condition is entered in the head row, the table will clear all events and fill itself with matching events as they are found from the beginning of the trace.</p>
163 <p>A status row will be displayed before and after the matching events, dynamically showing how many matching events were found and how many events were processed so far. Once the filtering is completed, the status row icon in the left margin will change from a 'stop' to a 'filter' icon.</p>
164 <p>
165 <img border="0" src="images/TmfEvents-Filter.png"/>
166 </p>
167 <p>Press
168 <b>ESC</b> to stop an ongoing filtering. In this case the status row icon will remain as a 'stop' icon to indicate that not all events were processed.
169 </p>
170 <p>Press
171 <b>DEL</b> or right-click on the table and select
172 <b>Clear Filters</b> from the context menu to clear the header row and remove the filtering. All trace events will be now shown in the table. Note that the currently selected event will remain selected even after the filter is removed.
173 </p>
174 <p>You can also search on the subset of filtered events by toggling the header row to the Search Bar while a filter is applied. Searching and filtering conditions are independent of each other.</p>
1507e5df
BH
175 <h4 id="Bookmarking">Bookmarking</h4>
176 <p>Any event of interest can be tagged with a bookmark.</p>
177 <p>To add a bookmark, double-click the left margin next to an event, or right-click the margin and select
178 <b>Add bookmark...</b>. Alternatively use the
179 <b>Edit</b> &gt;
180 <b>Add bookmark...</b> menu. Edit the bookmark description as desired and press
181 <b>OK</b>.
182 </p>
183 <p>The bookmark will be displayed in the left margin, and hovering the mouse over the bookmark icon will display the description in a tooltip.</p>
184 <p>The bookmark will be added to the
185 <b>Bookmarks</b> view. In this view the bookmark description can be edited, and the bookmark can be deleted. Double-clicking the bookmark or selecting
186 <b>Go to</b> from its context menu will open the trace or experiment and go directly to the event that was bookmarked.
187 </p>
188 <p>To remove a bookmark, double-click its icon, select
189 <b>Remove Bookmark</b> from the left margin context menu, or select
190 <b>Delete</b> from the Bookmarks view.
191 </p>
192 <p>
193 <img border="0" src="images/Bookmarks.png"/>
194 </p>
f01efa62 195 <h2 id="Histogram_View">Histogram View</h2>
b786e799 196 <p>The Histogram View displays the trace events distribution with respect to time. When streaming a trace, this view is dynamically updated as the events are received.</p>
70f06a6f
FC
197 <p>
198 <img border="0" src="images/HistogramView.png"/>
199 </p>
b786e799 200 <p>On the top left, there are two data controls:</p>
70f06a6f
FC
201 <ul>
202 <li>
203 <b>Current Event (sec)</b>: Displays the timestamp of the currently selected event
204 </li>
205 <li>
206 <b>Window Span (sec)</b>: Displays the current time range window size
207 </li>
b786e799
FC
208 </ul>
209 <p>Both control can be used to modify their respective value. After validation, the other controls and views will be synchronized and updated accordingly.</p>
210 <p>The large histogram, at the bottom, shows the event distribution over the whole trace or set of traces. It also has a smaller semi-transparent window, with a cross-hair, that shows the currently selected time range window. The time range window can be zoomed in/out by using the mouse wheel. It can also be selected by the mouse and dragged to another region of the trace.</p>
211 <p>The smaller histogram, on top right, corresponds to the currently selected time range window, a sub-range of the event set. Its size can also be zoomed in/out using the mouse wheel.</p>
212 <p>The x-axis of each histogram corresponds to the events timestamps. The timestamp of the first and the last event of the respective ranges is displayed. The y-axis of each histogram shows the minimum/maximum number of events in the corresponding histogram bars.</p>
213 <p>The dashed vertical magenta bar, on the right, shows the position of the last event. The dashed vertical red bar shows the relative position of the currently selected event. The current event can be changed by clicking on the histogram.</p>
214 <p>Hovering the mouse over an histogram bar pops up an information window that displays the start/end time of the corresponding bar as well as the number of events it represents.</p>
215 <p>In each histogram, the following keys are handled:</p>
216 <ul>
217 <li>
218 <b>Left</b>: Moves the current event to the previous non-empty bar
219 </li>
220 <li>
221 <b>Right</b>: Moves the current event to the next non-empty bar
222 </li>
70f06a6f 223 <li>
b786e799
FC
224 <b>Home</b>: Displays the current event to the first histogram bar
225 </li>
226 <li>
227 <b>End</b>: Displays the current event to the last non-empty histogram bar
70f06a6f
FC
228 </li>
229 </ul>
f01efa62 230 <h2 id="Control_Flow_View">Control Flow View</h2>
70f06a6f
FC
231 <p>The Control Flow View is applicable to kernel trace data. It displays the list processes in tabular format, sorted by PID, as well as their state transitions over time in a Gantt chart format.</p>
232 <p>
233 <img border="0" src="images/ControlFlowView.png"/>
234 </p>
235 <p>The tool bar options from left to right are:</p>
236 <ul>
237 <li>
238 <b>Home</b>: reset the time window to the whole trace range.
239 </li>
240 <li>
241 <b>Next Event</b>: sets the current event to the next event of the selected process.
242 </li>
243 <li>
244 <b>Previous Event</b>: sets the current event to the previous event of the selected process.
245 </li>
246 <li>
247 <b>Next Process</b>: sets the selected process to the next down in the list.
248 </li>
249 <li>
250 <b>Previous Process</b>: sets the selected process to the next up in the list.
251 </li>
252 <li>
253 <b>Zoom In</b>: zooms in the trace (i.e. shortens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
254 </li>
255 <li>
256 <b>Zoom Out</b>: zooms out the trace (i.e. widens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
257 </li>
258 <li>
259 <b>Filter</b>: display only the processes that have a state transition in the current window.
260 </li>
261 </ul>
262 <p>The process table displays the following fields:</p>
263 <ul>
264 <li>
265 <b>Process</b>: the process name if know (
266 <i>UNNAMED</i> otherwise)
267 </li>
268 <li>
269 <b>Brand</b>:
270 </li>
271 <li>
272 <b>PID</b>: the process ID
273 </li>
274 <li>
275 <b>TGID</b>:
276 </li>
277 <li>
278 <b>PPID</b>: the parent PID
279 </li>
280 <li>
281 <b>CPU</b>: the CPU/core the process is running on
282 </li>
283 <li>
284 <b>Birth sec/nsec</b>: the birth time of the process (
285 <i>0</i> if unknown) - seconds and nanoseconds
286 </li>
287 <li>
288 <b>TRACE</b>: the name of the trace that holds this process
289 </li>
290 </ul>
291 <p>The graphical part shows the state of the corresponding process
292 <i>a la Gantt</i>: the color represents the process state and the length of the bar represents the time span during which the process was in that state. The header corresponds to a time axis.
293 Note that depending on the scale or zooming factor, some pixels might represent more (in fact many, many more) than just one state.
294 </p>
295 <p>Here's a list of possible colors and their corresponding process state:</p>
296 <p>
297 <img border="0" src="images/LTTngControlFlowColorLegend.png"/>
298 </p>
299 <ul>
300 <li>
301 <b>MODE_UNKNOWN</b> - Process state is unknown: there is not enough information in the trace to determine the state. This usually occurs for processes already alive when tracing started and the system is unable to infer the original state from the following trace events.
302 </li>
303 <li>
304 <b>USER_MODE</b> - Running in user mode: the process is executing user source code or library calls (in user space).
305 </li>
306 <li>
307 <b>SYSCALL</b> - Running in system call: the process is doing a system call to the kernel and the running mode switched from process limited rights to super user mode.
308 </li>
309 <li>
310 <b>IRQ</b> - Servicing an IRQ: the currently running process is interrupted by an IRQ. As the IRQ does not change the currently running process (on some architectures it uses the same stack as the process), the IRQ state is shown in the state of the process. IRQ can be nested: a higher priority interrupt can interrupt a lower priority interrupt.
311 </li>
312 <li>
313 <b>TRAP</b> - Running in a trap: the kernel is running a trap that services a fault. The most frequent trap is the memory page fault trap, called every time a page is missing from physical memory.
314 </li>
315 <li>
316 <b>WAIT</b> - Waiting on I/O: the process is waiting for an I/O operation to complete before it can continue its execution.
317 </li>
318 <li>
319 <b>UNNAMED</b> - Mode unnamed: see
320 <b>MODE_UNKNOWN</b>
321 </li>
322 <li>
323 <b>WAIT_FORK</b> - Waiting for fork: the process has just been created by its parent and is waiting for first scheduling.
324 </li>
325 <li>
326 <b>WAIT_CPU</b> - Waiting for CPU: the process is ready to run but waiting to get the CPU (a schedule in event).
327 </li>
328 <li>
329 <b>EXIT</b> - Process has exited: the process has exited, but still has the control of the CPU. It may happend if it has some tasks to do in the exit system call.
330 </li>
331 <li>
332 <b>ZOMBIE</b> - Zombie process: the process in in zombie state. This state happens when a process exits and then waits for the parent to wait for it (wait() or waitpid()).
333 </li>
334 <li>
335 <b>SOFTIRQ</b> - Running a soft IRQ handler: a SoftIRQ is normally triggered by an interrupt that whishes to have some work done very soon, but not "now". Doing the long part of a computation in a softirq that will be run just after the IRQ handler exits permits to do work while interrupts are enabled, without increasing the system latency.
336 </li>
337 </ul>
f01efa62 338 <h3 id="Mouse_Control">Mouse Control</h3>
70f06a6f
FC
339 <ul>
340 <li>Mouse Wheel
341 <ul>
342 <li>Forward - Zoom In.</li>
343 <li>Backward - Zoom Out.</li>
344 </ul>
345 </li>
346 </ul>
347 <ul>
348 <li>Mouse Drag
349 <ul>
350 <li>States Area - Moves the time window in the direction of the drag keeping current scale.</li>
351 <li>Time Scale Area - Changes the time scale to the time range from the start to the end of the drag action.</li>
352 </ul>
353 </li>
354 </ul>
355 <ul>
356 <li>Mouse Hover
357 <ul>
358 <li>Hovering the mouse selection over a state will trigger a tooltip display with additional information, including the start and end times as well as the name of the state associated to the color.</li>
359 </ul>
360 </li>
361 </ul>
362 <p>
363 <img border="0" src="images/LTTngProcessStateInfo.png"/>
364 </p>
f01efa62 365 <h2 id="Resources_View">Resources View</h2>
70f06a6f
FC
366 <p>The Resources View is applicable to kernel trace data. It displays the list system resources in tree format, grouped by trace, as well as their state transitions over time in a Gantt chart format.</p>
367 <p>
368 <img border="0" src="images/ResourcesView.png"/>
369 </p>
370 <p>The tool bar options from left to right are:</p>
371 <ul>
372 <li>
373 <b>Home</b>: reset the time window to the whole trace range.
374 </li>
375 <li>
376 <b>Next Event</b>: sets the current event to the next event of the selected process.
377 </li>
378 <li>
379 <b>Previous Event</b>: sets the current event to the previous event of the selected process.
380 </li>
381 <li>
382 <b>Next Process</b>: sets the selected process to the next down in the list.
383 </li>
384 <li>
385 <b>Previous Process</b>: sets the selected process to the next up in the list.
386 </li>
387 <li>
388 <b>Zoom In</b>: zooms in the trace (i.e. shortens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
389 </li>
390 <li>
391 <b>Zoom Out</b>: zooms out the trace (i.e. widens the current time window) at the current location. This can also be accomplished by using the mouse wheel in the graphical part.
392 </li>
393 <li>
394 <b>Filter</b>: display only the processes that have a state transition in the current window.
395 </li>
396 </ul>
397 <p>The resource tree displays the system resources whose state transitions were collected in the trace.</p>
398 <p>The graphical part shows the state of the corresponding resources
399 <i>a la Gantt</i>: the color represents the resource state and the length of the bar represents the time span during which the resource was in that state. The header corresponds to a time axis.
400 Note that depending on the scale or zooming factor, some pixels might represent more (in fact many, many more) than just one state.
401 </p>
402 <p>Here's a list of possible colors and their corresponding process state:</p>
403 <p>
404 <img border="0" src="images/LTTngResourcesColorLegend.png"/>
405 </p>
f01efa62 406 <h3 id="Mouse_Control_2">Mouse Control</h3>
70f06a6f 407 <p>See
f01efa62 408 <a href="LTTng-Perspective.html#Control_Flow_View">Control Flow View</a>
70f06a6f 409 </p>
f01efa62 410 <h2 id="Statistics_View">Statistics View</h2>
70f06a6f
FC
411 <p>The Statistics View displays the various event counters that are collected when analyzing a trace. The data is organized per trace.</p>
412 <p>
413 <img border="0" src="images/StatisticsView.png"/>
12bf6834 414 </p>
f01efa62
FC
415 <h2 id="Latency_View">Latency View</h2>
416 <p>The Latency View is applicable to kernel trace data. The Latency View initiates the analysis of an LTTng trace to determine the elapsed time between 2 related events (the latency), and then to plot the distribution of the latencies. </p>
12bf6834 417 <p>
f01efa62 418 <img border="0" src="images/LatencyView.png"/>
12bf6834 419 </p>
f01efa62
FC
420 <p>The analysis is done to the current active time range of the LTTng perspective. The Latency View consists of 2 different graphs. The left graph shows the latency in respect to the event time (start event). The right graph shows the latency distribution.</p>
421 <h3 id="Latency_vs_Time_Graph">Latency vs Time Graph</h3>
422 <p>This graph shows the latency in respect of the event time of the first event of the 2 related events. The x-axis of the graph corresponds to the start event time in seconds. The y-axis shows the latency in milli-seconds. Hovering the mouse over an plotted item pops up an information window that displays the start/end event time of the corresponding area in the horizontal direction, the start/end latecny time of the corresponding area in vertical direction as well as the number of latencies that fall into this square.</p>
12bf6834 423 <p>
f01efa62 424 <img border="0" src="images/LatencyGraphHover.png"/>
12bf6834 425 </p>
f01efa62
FC
426 <h3 id="Latency_Distribution">Latency Distribution</h3>
427 <p>This graph shows the latency distribution. The number of latency values that fall in the corresponding latency range are displayed. The x-axis of the distribution graph shows the latency in milli-seconds. The y-axis corresponds to the number of events (latency occurances). Hovering the mouse over a histogram bar pops up an information window that displays the number of events as well as the number of events it represents.</p>
12bf6834 428 <p>
f01efa62
FC
429 <img border="0" src="images/LatencyDistributionHover.png"/>
430 </p>
431 <h3 id="Mouse_Control_3">Mouse Control</h3>
432 <p>The mouse control is only applicaple for the
433 <b>Latency Distribution</b> graph.
434 </p>
12bf6834 435 <ul>
f01efa62
FC
436 <li>Mouse Wheel
437 <ul>
438 <li>Forward - Zoom in (in y-axix only).</li>
439 <li>Backward - Zoom out (in y-axis only).</li>
440 </ul>
12bf6834
FC
441 </li>
442 </ul>
f01efa62
FC
443 <p>After zooming in the zoom factor is displayed in brackets besides the title
444 <b>Latency Distribution</b>. Additionally, besides the y-axis a warning icon is drawn to indicate that the maximum height is not displayed. Hovering over this icon pops up an information window about warning icon.
12bf6834 445 </p>
12bf6834 446 <p>
f01efa62 447 <img border="0" src="images/LatencyDistributionZoom.png"/>
12bf6834 448 </p>
f01efa62
FC
449 <h3 id="Tool_Bar_Menu">Tool Bar Menu</h3>
450 <p>The latency view comes with serveral tool bar buttons and menu items for changing the bar width as well as for listing, adding and deleting of matching events.</p>
12bf6834 451 <p>
f01efa62 452 <img border="0" src="images/LatencyToolbar.png"/>
12bf6834
FC
453 </p>
454 <ul>
455 <li>
f01efa62
FC
456 <b>Increase bar width/height</b>: To increase the bar width of the
457 <b>Latency Distribution</b> and the square width and hight of the
458 <b>Latency vs Time</b> graph, select the button
459 <b>Increase bar width/height</b>. By default, the size is 2 pixels. The maximum size is 16.
12bf6834
FC
460 </li>
461 </ul>
462 <ul>
463 <li>
f01efa62
FC
464 <b>Decrease bar width/height</b>: To decrease the bar width of the
465 <b>Latency Distribution</b> and the square width and hight of the
466 <b>Latency vs Time</b> graph, select the button
467 <b>Decrease bar width/height</b>. By default, the size is 2 pixels. The minimum size is 1.
12bf6834
FC
468 </li>
469 </ul>
470 <ul>
471 <li>
f01efa62
FC
472 <b>List matching events</b>: To display the current list of event pairs to be matched, select the button
473 <b>List matching events</b>. A new dialog display will open with the list of matching events. To reset to the default list of matchin pairs, press button
474 <b>Reset to default pairs</b>.
12bf6834 475 </li>
b786e799 476 </ul>
12bf6834 477 <p>
f01efa62 478 <img border="0" src="images/LatencyListMatchingDialog.png"/>
323392ab
BH
479 </p>
480 <ul>
481 <li>
f01efa62
FC
482 <b>Add matching events</b>: To add a new pair of events to be matched, select the button
483 <b>Add matching events</b>. A new display will open for selecting a new pair of events. First select the start event from the provided list on the left. The select an end event on the right side. After that, press
484 <b>Add</b>. This will add a new entry to the list in the lower part of the display. After closing the dialog box, the trace will be parsed again using the new list of event pairs.
323392ab
BH
485 </li>
486 </ul>
12bf6834 487 <p>
f01efa62 488 <img border="0" src="images/LatencyAddMatchingDialog.png"/>
12bf6834
FC
489 </p>
490 <ul>
491 <li>
f01efa62
FC
492 <b>Delete matching events</b>: To delete a pair of events to be matched, select the button
493 <b>Delete matching events</b>. A new display will open for selecting of pairs of events. First select the event pair to be deleted, then press button
494 <b>Delete</b>. After closing the dialog box, the trace will be parsed again using the new list of event pairs.
12bf6834
FC
495 </li>
496 </ul>
12bf6834 497 <p>
f01efa62 498 <img border="0" src="images/LatencyDeleteMatchingDialog.png"/>
12bf6834 499 </p>
12bf6834 500 <p>
f01efa62 501 <b>Note</b> that the list of event pairs are presisted in the workspace and will be available after restart of Eclipse.
70f06a6f
FC
502 </p><hr/>
503 <table class="navigation" style="width: 100%;" border="0" summary="navigation">
504 <tr>
505 <td style="width: 20%" align="left">
506 <a href="Getting-Started.html" title="Getting Started">
507 <img alt="Previous" border="0" src="../../../images/prev.gif"/>
508 </a>
509 </td>
510 <td style="width: 60%" align="center">
6dc1ef9f
FC
511 <a href="User-Guide.html" title="LTTng Plug-in User Guide (legacy)">
512 <img alt="LTTng Plug-in User Guide (legacy)" border="0" src="../../../images/home.gif"/>
70f06a6f
FC
513 </a>
514 </td>
515 <td style="width: 20%" align="right">
1507e5df 516 <a href="LTTng-Tracer-Control.html" title="LTTng Tracer Control">
70f06a6f
FC
517 <img alt="Next" border="0" src="../../../images/next.gif"/>
518 </a>
519 </td>
520 </tr>
521 <tr>
522 <td style="width: 20%" align="left" valign="top">Getting Started</td>
523 <td style="width: 60%" align="center"></td>
1507e5df 524 <td style="width: 20%" align="right" valign="top">LTTng Tracer Control</td>
70f06a6f
FC
525 </tr>
526 </table>
527 </body>
528</html>
This page took 0.058474 seconds and 5 git commands to generate.