Set up environment variables for Intel® oneAPI Toolkits:
On Linux* OS:

source <install-dir>/setvars.sh

On Windows* OS:

<install-dir>/setvars.bat
where
<install-dir>
is an installation directory for Intel® oneAPI Toolkits. By default, it is
/opt/intel/oneapi/
on Linux OS and
C:\Program Files (x86)\Intel\oneAPI\
on Windows OS.
On Windows OS: Set the
INTEL_JIT_BACKWARD_COMPATIBILITY=1
environment variable to use the JIT profiling API.
For DPC++ code: Force offloading to a CPU using one of the following:
Set the
SYCL_DEVICE_TYPE=CPU
and
SYCL_BE=PI_OPENCL
environment variables (recommended).
If your application uses a SYCL device selector: In the application source code, specify the CPU as the target device using
sycl::cpu_selector
. For details, see Device selector in the DPC++ Reference.
For OpenMP code: Force offloading to a CPU with one of the following:
To offload code to CPU, set the
OMP_TARGET_OFFLOAD=MANDATORY
and
LIBOMPTARGET_DEVICETYPE=CPU
variables (recommended).
To run code natively on CPU, set the
OMP_TARGET_OFFLOAD=DISABLED
variable.
By default, the environment variables are set to
OMP_TARGET_OFFLOAD=MANDATORY
and
LIBOMPTARGET_DEVICETYPE=GPU
for OpenMP target applications to be offloaded to a GPU.
For OpenCL code: Configure your code to be offloaded to a CPU. Refer to the OpenCL documentation at https://www.khronos.org/registry/OpenCL/ for specific instructions.
Build your application as usual.
When collecting performance metrics and modeling performance with
Intel Advisor
, enable analyzing dynamic (or JIT-compiled) loops.
From user interface:
File
Project Properties
Analysis Target
Trip Counts and FLOP Analysis
Advanced
Capture metrics for dynamic loops and functions
From command line interface: Use
--profile-jit
option when collecting Trip Counts data.
The
--profile-jit
option automatically enables
--assume-hide-taxes
for performance modeling, which hides all invocation taxes except the first one in the report. For details, see Manage Invocation Taxes.

OpenMP* Example

Set up environment variables:
source <install-dir>/setvars.sh
Set up variables to offload code to CPU:
export OMP_TARGET_OFFLOAD=MANDATORY
export LIBOMPTARGET_DEVICETYPE=CPU
Collect performance metrics with Survey analysis:
advisor --collect=survey --stackwalk-mode=online --static-instruction-mix --project-dir=./advi -- omp_application
Enable data collection for dynamic loops and functions and collect Trip Counts and FLOP data:
advisor --collect=tripcounts --flop --enable-data-transfer-analysis --profile-jit --target-device=gen11_gt2 --project-dir=./advi -- omp_application
Model application performance on a target device:
advisor --collect=projection --no-assume-dependencies --project-dir =./advi
Open the generated report in the
Intel Advisor
graphical user interface (GUI) or open an HTML report located at
<project-dir>
/e
<NNN>
/pp
<NNN>
/data.0

DPC++ Example

Set up environment variables:
<install-dir>\setvars.bat
Enable JIT profiling API:
set INTEL_JIT_BACKWARD_COMPATIBILITY=1
Set up variables to offload code to CPU:
set SYCL_DEVICE_TYPE=CPU
set SYCL_BE=PI_OPENCL
Launch the
Intel Advisor
GUI.
Create a project for your application.
Go to
File
Project Properties
Analysis Target
Trip Counts and FLOP Analysis
Advanced
and select
Capture metrics for dynamic loops and functions
to enable data collection for dynamic loops and functions.
Run the
Offload Modeling
perspective with your desired configuration and view the report.