Eclipse LTTng plugin

TMF (Tracing and Monitoring Framework, also simply called "LTTng plugin") is an Eclipse plugin currently in development to view LTTng kernel and userspace traces. It is part of the Linux Tools project at Eclipse.



How to install TMF

Install the latest stable version (1.0) from the Eclipse website

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

Eclipse requires a recent version of Java to run. OpenJDK 6 (or 7) is recommended, and can be installed from most distros' package managers.

Install TMF from the Ubuntu PPA

If you use Ubuntu 12.04, you can install TMF from the Eclipse LTTng PPA. See the instructions on that page.

Install the latest development snapshot

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 (CTF Kernel Trace for LTTng kernel traces, or Generic CTF 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.