/Download

Source code

Build LTTng
from source

Archives:

LTTng-tools
LTTng-UST
LTTng-modules

More documentation on how to build the following packages may be found in their README.md files, which are rendered as rich text when viewed on GitHub.

Please note that LTTng-tools supports both LTTng-modules (Linux kernel tracer) and LTTng-UST (user space tracer) released as part of the same minor release series. While some releases do not change the tracer ABIs and should work with previous versions of the tracers, no testing is performed to ensure that cross-version compatibility is maintained.

Applications instrumented with older versions of the LTTng-UST project do not have to be rebuilt or modified to work with the latest LTTng-tools.

LTTng 2.7 "Herbe à Détourne"? (current release)

LTTng 2.8 "Isseki Nicho"? (latest release candidates)

LTTng 2.6 "Gaïa"? (previous release)

Git

Prefer cloning?

We do too.

LTTng-tools

git clone git://git.lttng.org/lttng-tools.git

LTTng-UST

git clone git://git.lttng.org/lttng-ust.git

LTTng-modules

git clone git://git.lttng.org/lttng-modules.git

If you're using Ubuntu, executing this Bash script installs the appropriate dependencies, clones the LTTng Git repositories, builds the projects, and installs them. The sources are cloned into ~/src. Your user needs to be a sudoer for the install steps to be completed.

Git

Prefer cloning?

We do too.

Ubuntu

Ubuntu

LTTng 2.7 available on
Ubuntu 16.04 Xenial Xerus and on any current Ubuntu release using the
LTTng latest stable PPA

LTTng 2.6 available on Ubuntu 15.10 Wily Werewolf

LTTng is available on Ubuntu since Ubuntu 12.04 Precise Pangolin.

Two sources of LTTng packages are available for Ubuntu: official repositories and PPA.

Official repositories

To install LTTng from the official Ubuntu repositories, simply use apt-get:

sudo apt-get install lttng-tools
sudo apt-get install lttng-modules-dkms
sudo apt-get install liblttng-ust-dev

If you need to trace Java applications, you need to install the LTTng-UST Java agent also (available since Ubuntu 15.10 Wily Werewolf):

sudo apt-get install liblttng-ust-agent-java

If you need to trace Python applications, you need to install the LTTng-UST Python agent also (available since Ubuntu 16.04 Xenial Xerus):

sudo apt-get install python3-lttngust

PPA

The LTTng latest stable PPA offers the latest stable versions of LTTng packages. To get packages from this PPA, follow these steps:

sudo apt-add-repository ppa:lttng/ppa
sudo apt-get update
sudo apt-get install lttng-tools
sudo apt-get install lttng-modules-dkms
sudo apt-get install liblttng-ust-dev
sudo apt-get install liblttng-ust-agent-java
sudo apt-get install python3-lttngust
Fedora

Fedora

LTTng-tools 2.6 and LTTng-UST 2.6 available on Fedora 22 and Fedora 23

Starting from Fedora 17, LTTng-tools and LTTng-UST packages are officially available using yum:

sudo yum install lttng-tools
sudo yum install lttng-ust

LTTng-modules still needs to be built and installed from source. For that, make sure that the kernel-devel package is already installed beforehand:

sudo yum install kernel-devel

Proceed on to fetch LTTng-modules' source. Build and install it as follows:

KERNELDIR=/usr/src/kernels/$(uname -r) make
sudo make modules_install

Note: If you need to trace Java or Python applications on Fedora, you need to build and install LTTng-UST from source.

Fedora

Fedora

LTTng-tools 2.6 and LTTng-UST 2.6 available on Fedora 22 and Fedora 23

Debian

Debian

LTTng 2.7 available on
Debian "stretch" and Debian "sid"

LTTng 2.5 available on Debian "jessie"

Starting from Debian "jessie", packages are officially available using apt-get:

sudo apt-get install lttng-tools
sudo apt-get install lttng-modules-dkms
sudo apt-get install liblttng-ust-dev

If you need to trace Java or Python applications, you need to install the LTTng-UST Java or Python agents also (available since Debian "stretch"):

sudo apt-get install liblttng-ust-agent-java
sudo apt-get install python3-lttngust
openSUSE

openSUSE
(and other RPM-based distributions)

LTTng 2.7 available on openSUSE Leap 42.1

LTTng 2.6 available on openSUSE 13.1 and openSUSE 13.2

openSUSE has LTTng packages since version 12.3.

Note: If you need to trace Java or Python applications on openSUSE, you need to build and install LTTng-UST from source.

openSUSE Leap

The openSUSE Leap 42.1 repository includes LTTng packages. Use zypper directly:

sudo zypper install lttng-tools
sudo zypper install lttng-modules
sudo zypper install lttng-ust-devel

Other openSUSE releases

To install LTTng on other openSUSE releases, you first need to add an entry to your repositories. All openSUSE LTTng repositories are available here. For example, the following adds the LTTng repository for openSUSE 13.2:

sudo zypper addrepo http://download.opensuse.org/repositories/devel:/tools:/lttng/openSUSE_13.2/devel:tools:lttng.repo

Then, refresh the package database:

sudo zypper refresh

and install lttng-tools, lttng-modules and lttng-ust-devel:

sudo zypper install lttng-tools
sudo zypper install lttng-modules
sudo zypper install lttng-ust-devel
openSUSE

openSUSE
(and other RPM-based distributions)

LTTng 2.7 available on openSUSE Leap 42.1

LTTng 2.6 available on openSUSE 13.1 and openSUSE 13.2

Arch Linux

Arch Linux

LTTng 2.7 available on latest Arch Linux

LTTng packages are available for Arch Linux in the AUR: lttng-tools, lttng-modules, and lttng-ust.

You can automate all this using Yaourt:

yaourt -S lttng-tools
yaourt -S lttng-modules
yaourt -S lttng-ust

If you need to trace Python applications, you need to install the LTTng-UST Python agent also:

If you're living on the edge, the AUR also contains the latest Git masters of those packages: lttng-tools-git, lttng-modules-git, and lttng-ust-git.

Enterprise distributions

Enterprise distributions

RHEL and SLES

To install LTTng on enterprise distributions, e.g., RHEL and SLES, please see EfficiOS Enterprise Packages.

Enterprise distributions

Enterprise distributions

RHEL and SLES

Buildroot

Buildroot

LTTng 2.6 available since Buildroot 2015.05

LTTng 2.5 available on Buildroot 2014.11 and Buildroot 2015.02

LTTng packages in Buildroot are named lttng-tools, lttng-modules and lttng-libust. To enable them, start the Buildroot configuration menu as usual:

make menuconfig

In:

  • Kernel: make sure Linux kernel is enabled
  • Toolchain: make sure the following options are enabled:
    • Enable large file (files > 2GB) support
    • Enable WCHAR support

In Target packages/Debugging, profiling and benchmark, enable lttng-modules and lttng-tools.

In Target packages/Libraries/Other, enable lttng-libust.

Note: If you need to trace Java or Python applications on Buildroot, you need to build and install LTTng-UST from source.

OpenEmbedded/Yocto

OpenEmbedded
and Yocto

LTTng 2.6 available on OpenEmbedded/Yocto since February 8th, 2015

LTTng recipes are available in the openembedded-core layer of OpenEmbedded:

  • lttng-tools
  • lttng-modules
  • lttng-ust

Using BitBake, the simplest way to include LTTng recipes in your target image is to add them to IMAGE_INSTALL_append in conf/local.conf:

IMAGE_INSTALL_append = " lttng-tools lttng-modules lttng-ust"

If you're using Hob, click Edit image recipe once you have selected a machine and an image recipe. Then, in the All recipes tab, search for lttng and you should find and be able to include the three LTTng recipes.

Note: If you need to trace Java or Python applications on OpenEmbedded/Yocto, you need to build and install LTTng-UST from source.

OpenEmbedded/Yocto

OpenEmbedded
and Yocto

LTTng 2.6 available on OpenEmbedded/Yocto since February 8th, 2015