Experimental Linux SW tool to trace, process and analyze full stack SW traces utilizing Intel HW tracing block Intel PT (Intel Processor Trace).
SATT allows to trace Linux based OSes running in X86 which has Intel PT tracing block. Intel PT feature needs to be enabled in HW.
Currently it is possible to trace full SW stack from the Linux based system E.g. Android or Ubuntu linux.
Tracing does not need any additional HW, but Intel PT trace is collected in to RAM. In addition to HW instruction trace data, SATT collects needed info from running kernel, e.g. scheduling and memory map information needed to generate execution flow. Post-processing will generate function flow with timing and instruction count of each thread.
Web based UI will allow to study execution in function level from All CPU's, Processes, Threads and modules.
- SATT kernel module under GNU General Public License version 2.
- Rest of the SATT tool is licensed under Apache License, Version 2.0.
Needed libraries to build and use SATT
packages:
build-essential scons libelf-dev python-pip git binutils-dev autoconf libtool libiberty-dev zlib1g-dev python-dev (python-virtualenv) postgresql-9.x libpq-dev
- Create new empty directory for satt tool
- Copy satt/devel/get-satt.sh file to the created directory
- run get-satt.sh in the created directory:
./get-satt.sh
./bin/satt install --ui
satt devel build-ui
Simple instructions how to use SATT
satt config
satt build
NOTE: sudo needed in case tracing local machine
(sudo) satt trace
NOTE: sudo needed in case processing trace taken from local machine
(sudo) satt process <given-trace-name>
satt visualize <given-trace-name>
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.