Intel PTI

0.17.0 verified Mon Apr 27 auth: no python

Intel® Profiling Tools Interface (PTI) provides a Python API for processor trace (Intel PT) and hardware-based profiling. Version 0.17.0; release cadence irregular.

pip install intel-pti

Common errors

error ModuleNotFoundError: No module named 'intel_pti' ↓

cause Library not installed or wrong Python environment.

fix

Run 'pip install intel-pti' in the correct environment.

error AttributeError: module 'intel_pti' has no attribute 'PTI' ↓

cause Incorrect import (import intel_pti instead of from intel_pti import PTI).

fix

Use 'from intel_pti import PTI'.

error OSError: [Errno 2] No such file or directory: 'trace.pt' ↓

cause Trace file not found or path incorrect.

fix

Provide full path or ensure file exists in working directory.

Warnings

gotcha Intel PTI requires Intel PT hardware support (e.g., recent Intel CPUs). Running on unsupported hardware will raise or silently fail. ↓

fix Check CPU support via 'lscpu | grep intel_pt' or CPUID.

breaking API changed significantly between 0.15.x and 0.17.x; many classes moved to submodules. ↓

fix Update imports: 'from intel_pti.decode import TraceDecoder' instead of 'from intel_pti import TraceDecoder'.

deprecated Direct instantiation of PTI() without arguments may be deprecated in future; use context manager. ↓

fix Use 'with PTI() as pti:' pattern.

Imports

PTI
wrong
```
import intel_pti
```
correct
```
from intel_pti import PTI
```
Direct import of module does not expose PTI class; must use from import.

TraceDecoder

wrong

from intel_pti import TraceDecoder

correct

from intel_pti.decode import TraceDecoder

TraceDecoder is in the decode submodule, not top-level.

Quickstart

Initialize PTI, list sources, and decode a trace file.

from intel_pti import PTI

pti = PTI()
# List available trace sources
print(pti.list_sources())
# Decode a trace file (example)
from intel_pti.decode import TraceDecoder
decoder = TraceDecoder()
decoder.decode('trace.pt')