Intel® Advisor User Guide

ID 766448
Date 3/22/2024
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

gpu-kernel-of-interest

This option helps you to minimize data collection overhead by including exactly the GPU kernels you want to be profiled.

GUI Equivalent

Project Properties > Analysis Target > Survey Hotspots Analysis > GPU kernels of interest

Project Properties > Analysis Target > Characterization (with Trip Counts and FLOP enabled) > GPU kernels of interest

Syntax

--gpu-kernel-of-interest=<kernel_names>

Arguments

<kernel_names> is the list of GPU kernels to include in profiling. You can specify the necessary kernels in any of the following ways:

Enter the kernel names explicitly:

--gpu-kernel-of-interest=test_Q1,test_Q2

Use a mask with * and . special characters, where * indicates any number of characters, and . indicates a single character:

--gpu-kernel-of-interest=*Q1

If you want to explicitly instruct Intel Advisor to profile all GPU kernels, you can use *:

--gpu-kernel-of-interest=*

Combine several search strings, using a comma-separated list – in this case, a GPU kernel will be selected for analysis if at least one string is found in its name (-OR- logic is applied):

--gpu-kernel-of-interest=*Q1,*Q2

Default

If this option is not configured (default behavior), Intel Advisor will profile all kernels.

Actions Modified

collect

Usage

This option helps you to minimize data collection overhead. It is available for both Survey and Trip Counts collection.

Example

The following example runs a Survey analysis launched from myScript and profiles only the GPU kernels which names start with test.


advisor --collect=survey --profile-gpu -gpu-kernel-of-interest=test* -- ./myScript