Intel® VTune™ Amplifier

Running Custom Analysis from the Command Line

Use the collect-with action to configure and run a custom analysis using any of the following data collections:

Hardware Event-based Sampling

The hardware event-based sampling collector of the VTune Amplifier profiles your application using the counter overflow feature of the Performance Monitoring Unit (PMU).

Use the following command line syntax to run the custom hardware event-based sampling from the command line:

amplxe-cl -collect-with runsa [<-knob> <knob_name=knob_option>] [--] <target>

Note

For the most current information on available knobs (configuration options) for the hardware event-based sampling, enter:

amplxe-cl -help collect-with runsa

To display a list of events available on the target PMU, enter:

$ amplxe-cl -collect-with runsa -knob event-config=? <target>

The command returns names and short descriptions of available events. For more information on the events, use Intel Processor Events Reference

Example

This example runs a custom hardware event-based sampling collection for the sample application with the specified events.

$ amplxe-cl -collect-with runsa -knob event-config=CPU_CLK_UNHALTED.CORE,CPU_CLK_UNHALTED.REF,INST_RETIRED.ANY -- home/test/sample

User-Mode Sampling and Tracing

The user-mode sampling and tracing collector profiles an application execution and takes snapshots of how that application utilizes the processors in the system. The collector interrupts a process, collects the value of all active instruction addresses and captures a calling sequence for each of these samples.

Use the following command line syntax to run the custom user-mode sampling and tracing from the command line:

amplxe-cl -collect-with runss [<-knob> <knob_name=knob_option>] [--] <target>

Note

For the most current information on available knobs (configuration options) for the user-mode sampling and tracing, enter:

amplxe-cl -help collect-with runss

Example

This example runs user-mode sampling and tracing collection for the sample application with enabled loop analysis.

 amplxe-cl -collect-with runss -knob analyze-loops=true -- home/test/sample

See Also