Revision as of 19:37, 17 June 2016

This material is work-in-progress ...

Do not follow instructions here until this notice is removed.
(Last edited by Mjeanson on 17 Jun 2016.)

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 http ://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, see http ://lttng.org/docs/#doc-tracing-the-linux-kernel

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, see http ://lttng.org/docs/#doc-tracing-your-own-user-application

@@ Line 26: / Line 26: @@
 = 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.
 {{Cmd|apk add lttng-ust-dev}}