SATT Software Analyze Trace Tool
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
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
Install needed dependencies
Ubuntu 16.04 tracing PC example:
sudo apt install build-essential scons libelf-dev python-pip git binutils-dev autoconf libtool libiberty-dev zlib1g-dev python-dev python-virtualenv postgresql-9.5 libpq-dev
Clone or Download SATT tool
git clone https://github.com/01org/satt.git
./bin/satt install --ui
Installer will ask sudo access rights when needed
- Adds the satt command to to path
- Adds the satt to bash completion (sudo)
- Download and compile disassembler (Capstone)
- Compile SATT parser
- Install python virtual-env under /bin/env folder
- Install needed python packaged to virtual-env
When --ui flag used
- Adds satt user for postgres db (sudo)
- Adds satt db for postgres db (sudo)
satt devel build-ui
Simple instructions how to use SATT
Build SATT kernel module
NOTE: sudo needed in case tracing local machine
Process the traces
NOTE: sudo needed in case processing trace taken from local machine
satt process <given-trace-name>
Import & Launch UI
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.