User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 12/16/2022
Public

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

Document Table of Contents

target-duration-type

Adjust the sampling interval for longer-running targets.

GUI Equivalent

Configure Analysis window > WHAT pane > Duration time estimate option

Syntax

-target-duration-type veryshort | short | medium | long

Arguments

veryshort

Target takes less than 1 minute to run.

short

Target takes between 1 and 15 minutes to run.

medium

Target takes 15 minutes to 3 hours to run.

long

Target takes more than 3 hours to run.

Default

short
This is appropriate for a target that runs for 1 to 15 minutes.

Actions Modified

collect, collect-with

Description

If your target runs 15 minutes or longer, or if it runs less than one minute, use the target-duration action-option to set a different duration type. The collect or collect-with action uses this value to adjust the sampling interval, which determines how much data is collected. For longer-running targets, the sampling interval is greater (less frequent) to reduce the amount of collected data. For very short-running targets, the sampling interval is smaller (more frequent). For hardware event-based analysis types, a multiplier applies to the configured Sample After value.

NOTE:

This option is deprecated. Use the -knob sampling-interval option instead.

Example

Perform a Hotspots analysis using a medium sampling interval that is appropriate for targets with a duration of 15 minutes to 3 hours.

vtune -collect hotspots -knob sampling-mode=hw -target-duration-type medium -- MyApp