Commit | Line | Data |
---|---|---|
2b042910 BH |
1 | = Overview = |
2 | The Linux Tools Trace Viewer is a stand-alone application based on Eclipse's | |
3 | Rich Client Platform (RCP). The purpose of this is to provide a lightweight | |
4 | application to view and analyze traces. It includes all TMF (Tracing and | |
5 | Monitoring Framework) features, as well as all features from the LTTng (Linux | |
6 | Tracing Toolkit next generation) Eclipse integration, which are provided by the | |
7 | Linux Tools Project. | |
8 | ||
9 | = Getting Started = | |
10 | To start the Linux Tools Trace Viewer, go to the directory where the Trace | |
11 | Viewer is installed and then run the application named '''traceViewer'''. | |
12 | During startup, the Trace Viewer will create, if necessary, an Eclipse workspace | |
13 | in the user's home directory with the name ''.traceviewer''. It also creates, if | |
14 | needed, a default tracing project called ''Tracing''. | |
15 | ||
16 | Now the application can be used as described in the User Guide for Linux Tools | |
17 | LTTng integration (see section [[#References | References]]). | |
18 | ||
76fccfb0 | 19 | = Opening a Trace = |
1aec2e92 BH |
20 | To open a trace, click on the '''File''' menu and select '''Open Trace...'''. |
21 | A new dialog will show for selecting a trace to open. Select a trace file | |
22 | and then click on '''OK'''. Note that for traces that are directories | |
23 | (such as Common Trace Format (CTF) traces) any file in the trace directory can | |
24 | be selected to open the trace. Now, the trace viewer's auto detection algorithm | |
25 | will validate the trace against all known trace types. If multiple trace types | |
d3e89107 BH |
26 | are valid, a trace type is chosen based on a confidence criteria. The |
27 | validation process and the computation of the confidence level are trace type | |
28 | specific. After successful validation the trace will be opened with the | |
29 | detected trace type. | |
30 | ||
31 | Alternatively the user can launch the trace viewer with the command-line | |
32 | argument '''--open <trace-path>'''. The trace will then automatically open | |
33 | using the same algorithm than described above. | |
76fccfb0 MK |
34 | |
35 | In both of the above cases, the trace will be linked to the default project. | |
36 | ||
2b042910 BH |
37 | = References = |
38 | ||
39 | * [http://www.eclipse.org/linuxtools/projectPages/lttng/ Linux Tools - LTTng integration] | |
40 | * [http://www.lttng.org/ LTTng project] | |
2b042910 | 41 |