The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

This material is work-in-progress ...

Do not follow instructions here until this notice is removed.
(Last edited by Sertonix on 7 Aug 2023.)

Installation

apk add lttng-tools

Kernel tracing

The kernel tracing part of LTTng requires out of tree modules to be built against the running kernel. These modules depend on the tracepoint facility which is disabled in the current Alpine Linux grsec kernel. However, the alternate vanilla kernel has all the required options built-in.

apk add linux-vanilla linux-vanilla-dev

Reboot with the vanilla kernel, you'll have to either change the default kernel flavour in /etc/update-extlinux.conf or uninstall the grsec kernel. Then build the LTTng modules from source.

wget https://lttng.org/files/lttng-modules/lttng-modules-latest-2.8.tar.bz2 tar xvf lttng-modules-latest-2.8.tar.bz2 cd lttng-modules-* make sudo make install sudo depmod

If you have an already running lttng-sessiond at this point, it will need to be restarted to enable kernel tracing.

For more information on kernel tracing, read Tracing the Linux kernel in the lttng’s documentation.

Userspace tracing

The userspace tracing part of LTTng requires your application to be instrumented and linked with liblttng-ust, on Alpine you'll need the lttng-ust-dev package.

apk add lttng-ust-dev

For more information on userspace tracing, read Tracing your own user application in the lttng’s documentation.