Eclipse LTTng plugin

TMF (Tracing and Monitoring Framework) is a trace viewer and analyzer for many trace types, including LTTng kernel and userspace traces. It is part of the Linux Tools project at Eclipse, under the name "LTTng plugin".



How to install TMF

Install the stand-alone RCP version

The easiest way to use the viewer is to use the RCP (Rich Client Platform) version. It's a stand-alone application that only requires a Java runtime (tested with OpenJDK 7, which should be available in most distros' package managers).

Pre-compiled builds for different platforms are available here. Simply extract the archive and run the "traceViewer" binary.

To build the RCP package yourself, checkout the git tree (see below), and check the lttng/README file for instructions.

Note: There is a bug with recent Ubuntu versions where Eclipse applications do not get correctly blacklisted for the application menu, which means you may end up with an unusable menu. To fix this, unset the UBUNTU_MENUPROXY environment variable, for example:

$ UBUNTU_MENUPROXY= ./traceViewer

(with a space after the =)

Install Eclipse plugin version

If you are already using the Eclipse IDE, you might be interested in the Eclipse plugin version. It can be added using the "Help -> Install New Software..." option, under the "Linux Tools" section of the main Eclipse repo.

You can also download the Eclipse IDE for C/C++ Developers from the Eclipse Downloads page, which already includes Linux Tools and the LTTng integration plugins.

Get the source code

The latest code is available from Git at:
git://git.eclipse.org/gitroot/linuxtools/org.eclipse.linuxtools.git (web)
(under the /lttng directory)

You can also use the nightly builds, which are available on this page. Since this is unstable code, be aware that it might not always be working as intented.

If you want the code itself to do development on it, you can follow this procedure to setup the development environment.


How to open a LTTng 2.x trace in Eclipse

After installing Eclipse and the plugins via one of the previous methods, opening a LTTng trace is a couple clicks away. Here's a quick procedure, refer to the User Guide for screenshots and detailed instructions.

  • Go to Window... -> Open Perspective -> Other..., and select the LTTng Kernel perspective.
  • Right-click in the Project view (the white area on the middle left), and select New -> Tracing Project. Name your project and click OK.
  • Open the project's tree, and right-click on Traces, then Import....
  • In the dialog that just opened, select the path to the trace you want to open, select the trace type (LTTng Kernel Trace for LTTng kernel traces, or LTTng UST Trace for UST traces), and click OK.
  • Double-click the trace in the project tree to load it. The views should now be updated with the trace's contents.

You can also create an experiment, select multiple traces to be part of it, then double-click the experiment to open more than one trace at the same time.


See the User Guide on the Eclipse wiki for more information.

Any questions regarding TMF should be directed at the linuxtools-dev mailing list.