This section describes the installation of the LTTng tracer and the Trace Compass plug-ins as well as their dependencies.

LTTng Tracer

While the Eclipse plug-ins can run on the standard Eclipse platforms (Linux, Mac, Windows), the LTTng tracer and its accompanying tools run on Linux.

The tracer and tools have been available for download in Ubuntu since 12.04. They can easily be installed with the following command:

  > sudo apt-get install lttng-tools

For other distributions, older Ubuntu distributions, or the latest, bleeding edge LTTng tracer, please refer to the LTTng website for installation information.

Note: The LTTng tracer (and accompanying tools) is required only if you want to create your own traces (the usual case). If you intend to simply analyze existing traces then it is not necessary to install the tracer.

Trace Compass Plug-ins

The easiest way to install the Trace Compass plug-ins for Eclipse is through the Install New Software menu. For information on how to use this menu, refer to this link.

The Trace Compass main plug-ins are structured as a stack of features/plug-ins as following:

LTTng Control Dependencies

The Eclipse LTTng Control feature controls the LTTng tracer through an ssh connection, if the tracer is running locally it can use or bypass the ssh connection.

When using ssh, the target system (where the tracer runs) needs to run an ssh server as well as sftp server (for file transfer) to which you have permission to connect.

On the host side (where Eclipse is running), you also need to have Eclipse Remote Services installed to handle the SSH connection and transport. The Remote Services are installed for you as a dependency of the LTTng Control feature. If necessary, it can be installed manually with the standard way ( Help > Install New Software... > General Purpose Tools > Remote Services).

Installation Verification

If you do not have any traces, sample LTTng traces can be found here This page contains links to some sample LTTng 2.0 kernel traces. The trace needs to be uncompressed to be opened. The traces can also be imported directly as archive, see the Importing section for more detail.

Here are the quick steps to verify that your installation is functional using a LTTng trace:

If an error message is displayed, you might want to double-check that the trace type is correctly set (right-click on the trace and "Select Trace Type...").

Refer to Tracing Perspective for detailed description of the views and their usage.