- Last edited 4 months ago ago
1 Article purpose
This article provides basic information to start using the Linux tool: sysdig.
The following table provides a brief description of the tool, as well as its availability depending on the software packages:
|Tool||STM32MPU Embedded Software distribution||STM32MPU Embedded Software distribution for Android™ |
|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:
- 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
|Document link||Document Type||Description|
|sysdig manpage||Standard||Man page from Official github|
|sysdig wiki documentation||User Guide||Documentation from Official github|