Last edited 10 months ago

LTTng

Applicable for STM32MP13x lines, STM32MP15x lines, STM32MP25x lines

1. Article purpose[edit | edit source]

This article provides the basic information needed to start using the Linux® tracing tool: LTTng[1] (Linux Trace Toolkit, next generation).

2. Introduction[edit | edit source]

The following table provides a brief description of the tool, as well as its availability depending on the software packages:

Yes: this tool is either present (ready to use or to be activated), or can be integrated and activated on the software package.

No: this tool is not present and cannot be integrated, or it is present but cannot be activated on the software package.

Tool STM32MPU Embedded Software distribution STM32MPU Embedded Software distribution for Android™
Warning white.png Warning
No Developer Package is presently delivered.
The tool (even if marked as present) has not been yet tested with the current release.
Name Category Purpose Starter Package Developer Package Distribution Package Starter Package Developer Package Distribution Package
LTTng Tracing tools LTTng[1] is an open source tracing framework for Linux kernel and user spaces. It is a powerful tool that can be used for many purposes. LTTng traces need to be processed/displayed with a host tool such as Trace Compass[2], based on Eclipse plugin for increased portability. No No Yes No No No

This tool is composed of 3 parts:

  • lttng-ust: user space libs
  • lttng-tools: user space tools
  • lttng-modules: kernel modules

3. Installing the trace and debug tool on your target board[edit | edit source]

3.1. Using STM32MPU Embedded Software distribution[edit | edit source]

OpenSTLinux embeds lttng-ust and lttng-tools by default.

The LTTng Kernel space is not installed/activated by default in OpenSTLinux to avoid increasing the roofs size.

To use LTTng in OpenSTLinux you need to both:

  • activate 'Kernel Function Tracer'. the Linux kernel configuration must activate CONFIG_FUNCTION_TRACER and CONFIG_FUNCTION_GRAPH_TRACER using the Linux kernel Menuconfig tool (Menuconfig or how to configure kernel):
Symbol: FUNCTION_TRACER
Location:
  Kernel Hacking --->
    Tracers -->
      [*] Kernel Function Tracer

Symbol: FUNCTION_GRAPH_TRACER
Location:
  Kernel Hacking --->
    Tracers -->
      [*] Kernel Function Tracer
       [*] Kernel Function Graph Tracer
Info white.png Information

This trace framework is not activated by default in OpenSTLinux distributions since there is an impact on the Linux kernel size (around 1.5% increase of vmlinux), and also an impact on the overall performance, because of additional processing done to trace kernel events and function calls.

  • compile and install lttng-modules

lttng is integrated in weston image distribution through openembedded-core package: openembedded-core/meta/recipes-core/packagegroups/packagegroup-core-tools-profile.bb.

RDEPENDS_${PN} = "\
    ${PROFILETOOLS} \
    ${LTTNGUST} \
    ${LTTNGTOOLS} \
    ${LTTNGMODULES} \
    ${BABELTRACE} \
    ${SYSTEMTAP} \
    ${VALGRIND} \
    "

however, lttng-modules is removed in meta-st package: meta-st/meta-st-openstlinux/recipes-core/packagegroups/packagegroup-core-tools-profile.bbappend.

RDEPENDS_${PN}_remove = "${LTTNGMODULES}"

3.1.1. Developer Package[edit | edit source]

It is not recommended to enable Linux kernel configuration for LTTng by using Developer Package because all external modules should also be recompiled (e.g. gcnano driver for STM32MP15x lines More info.png and STM32MP25x lines More info.png GPU when supported), and this is not possible with Developer Package (which does not necessary provide all sources).

That is the reason why this is set as 'not supported' for Developer Package.

3.1.2. Distribution Package[edit | edit source]

If you have already activated the requested configuration for ftrace, then you can go directly to "Compile lttng-modules" item.

  • Compile lttng-modules
Comment line meta-st package: meta-st/meta-st-openstlinux/recipes-core/packagegroups/packagegroup-core-tools-profile.bbappend.
-RDEPENDS_${PN}_remove = "${LTTNGMODULES}"
+#RDEPENDS_${PN}_remove = "${LTTNGMODULES}"
  • Re-build the image in order to integrate new Linux kernel uImage and LTTng modules.
 bitbake st-image-weston

4. Getting started[edit | edit source]

The best way to get started with LTTng is to have a look to the official webpage of LTTng[1].

4.1. Activate and generate traces on target side[edit | edit source]

Some useful information can be found in LTTng documentation[3].

Kernel tracing example[4]:

Create a tracing session:
 lttng create my-kernel-session

List the available kernel tracepoints and system calls:
 lttng list --kernel

Create an event rule that matches the desired event names, for example sched_switch and sched_process_fork:
 lttng enable-event --kernel sched_switch,sched_process_fork

You can also create an event rule that matches all the Linux kernel tracepoints (this will generate a lot of data when tracing):
 lttng enable-event --kernel --all

Start tracing:
 lttng start

Generate activity on your system for a few seconds. For example, start an application, load a kernel module, or list the files within a directory...

Stop tracing and destroy the tracing session:
 lttng stop
 lttng destroy
The destroy command does not destroy the trace data; it only destroys the state of the tracing session.

4.2. Import LTTng traces in a Trace Compass trace viewer[edit | edit source]

4.2.1. Host Installation for Trace Compass[edit | edit source]

Even if LTTng are tools running on target, the analysis of the traces generated by LTTng tools should be done with host tools like Trace Compass[2].

So first you have to download and install/run the Trace Compass tool[5]: download the last version (or at least TraceCompass-3.2.0).

4.2.2. Visualize LTTng trace with Trace Compass[edit | edit source]

Once the trace have been generated you can use Trace Compass[2] to visualize your traces, interpreted in dedicated context view.

  • First ensure you can open an ssh session with your board. But close it after, because no ssh session must be open for the next steps
 ssh root@<ip_of_remote_board>


 exit
logout
Connection to <ip_of_remote_board> closed.


  • Open Trace Compass and fetch the remote trace:

TraceCompass fetchRemoteTrace.png

  • Click on Manage profile to select/add the profile matching your setup (STBoards connection through ssh, ...)

TraceCompass ManageProfile.png

  • If needed add a new profile: in this case, a profile named STBoards with ssh connection

TraceCompass ManageProfileAdd.png

  • Take care about the search path, by default Trace Compass looks for a wrong search path, please correct it

TraceCompass setRemoteSearchPath.png

  • End by clicking on finish button

Note that sometimes it fails to get logs at the first trial, do not hesitate to try again.
TraceCompass FetchRemoteTraceFinish.png

  • Your traces will be loaded on Trace Compass, and you can see them on the Project explorer on the left.

In the example below 5 traces have been loaded:
TraceCompass TraceLoading.png

  • Open the trace

To open the trace, left-click on the kernel item corresponding to your trace, then Open.

  • Check for trace on the right panels

TraceCompass TraceDisplay.png

5. References[edit | edit source]