Sysdig

Applicable for

STM32MP13x lines, STM32MP15x lines

---

1. Article purpose

This article provides basic information to start using the Linux tool: sysdig.

2. Introduction

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

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

: 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 STM32MPU Embedded Software distribution for Android™ is no more supported by ST. You can contact our ST partner, Witekio, who can help you to port and maintain it on STM32MP15 platform.
Name	Category	Purpose	Starter Package	Developer Package	Distribution Package	Starter Package	Developer Package	Distribution Package
sysdig	Monitoring tools	sysdig is a tool for system troubleshooting, analysis and exploration. It can be used to capture, filter and decode system calls and other OS events.

sysdig can be both used to inspect live systems or to generate trace files that can be analyzed at a later stage.

It includes a powerul filtering language, has customizable output, and can be extended through Lua scripts, called chisels.

sysdig aims to replace a collection of tools, as lsof, strace, iostat, ps, etc...

3. Installing the trace and debug tool on your target board

sysdig is a user space application which is not part of the standard STM32MPU Embedded Software distribution image and Packages. It has to be integrated as an external component.

Linux kernel configuration must also enable CONFIG_TRACEPOINTS and CONFIG_HAVE_SYSCALL_TRACEPOINTS:

Symbol: TRACEPOINTS [=y]
Selected by: TRACING [=y] || BLK_DEV_IO_TRACE [=n] && TRACING_SUPPORT [=y] && FTRACE [=y] && SYSFS [=y] && BLOCK [=y]

Symbol: HAVE_SYSCALL_TRACEPOINTS [=y]
Selected by: ARM [=y]

3.1. Using STM32MPU Embedded Software distribution

On STM32MPU Embedded Software distribution(weston), Linux kernel configuration already enable the required configuration options.

3.1.1. Developer Package

There are too many dependencies for building sysdig application and kernel driver, that's the reason why this is recommended to use the Distribution package to integrate this tool.

3.1.2. Distribution Package

Yocto recipes for building sysdig are part of the OpenSTLinux distribution.

Following steps to be done to enable sysdig and add it to the st-image-weston image:

• Add sysdig package install for the image

 echo 'IMAGE_INSTALL_append += "sysdig-stm32mp"' >> layers/meta-st/meta-st-openstlinux/recipes-st/images/st-image-weston.bbappend
 echo 'IMAGE_INSTALL_append += "sysdig-driver"' >> layers/meta-st/meta-st-openstlinux/recipes-st/images/st-image-weston.bbappend

• Regenerate the image file:

 bitbake st-image-weston

• Update your board with the new image. See Flashing the built image.

4. Getting started

Below some basics commands extracted from official sysdig website:

5. To go further

Coming soon

6. References

"External links"

Document link	Document Type	Description
sysdig manpage	Standard	Man page from Official github
sysdig wiki documentation	User Guide	Documentation from Official github

Linux^® is a registered trademark of Linus Torvalds.

Operating system

input/output