intel Intel unitrace Setup
Set up unitrace from Intel PTI-GPU. Always check PATH first before building.
Instructions
Step 1: Check if unitrace is already available
which unitrace 2>/dev/null && unitrace --help > /dev/null 2>&1 && echo "UNITRACE_AVAILABLE" || echo "UNITRACE_NOT_FOUND"
- If found: Report the path. Use it directly unless the user explicitly asks to rebuild.
- If NOT found: Proceed to Step 2.
Step 2: Check prerequisites
which g++ 2>/dev/null || which icpx 2>/dev/null || echo "NO_CXX_COMPILER"
cmake --version 2>/dev/null || echo "NO_CMAKE"
echo "CMPLR_ROOT=${CMPLR_ROOT:-NOT_SET}"
python3 --version 2>/dev/null || echo "NO_PYTHON"
Required:
- CMake 3.22+
- C++17 compiler (g++ or icpx)
- Intel oneAPI (use the "source-oneapi" skill if not initialized)
- Python 3.9+
Step 3: Clone and build
Default location: $HOME/.local/src/pti-gpu.
mkdir -p "$HOME/.local/src"
cd "$HOME/.local/src"
git clone https://github.com/intel/pti-gpu.git
cd pti-gpu/tools/unitrace
mkdir -p build && cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make -j$(nproc)
If MPI is not available, add -DBUILD_WITH_MPI=0.
Build options:
| Option | Default | Description |
|---|---|---|
BUILD_WITH_MPI |
1 | MPI profiling |
BUILD_WITH_ITT |
1 | oneCCL/oneDNN profiling |
BUILD_WITH_XPTI |
1 | SYCL/UR profiling |
BUILD_WITH_OPENCL |
1 | OpenCL profiling |
Step 4: Add to PATH
export PATH="$HOME/.local/src/pti-gpu/tools/unitrace/build:$PATH"
Step 5: Verify
unitrace --help