Intel® VTune™ Amplifier
Intel® VTune™ Amplifier introduces analysis types based on the event-based sampling data collection. Use the amplxe-cl command tool to run the following microarchitecture analysis types:
General Exploration analysis collects a complete list of events for analyzing a typical client application. It calculates a set of predefined ratios used for the metrics and facilitates identifying hardware-level performance problems.
Use the following command line syntax to run the General Exploration analysis from the command line:
$ amplxe-cl -collect general-exploration [<-knob> [knob_name=knob_option]] [--] <target>
For the most current information on available knobs (configuration options) for the General Exploration analysis, enter:
$ amplxe-cl -help collect general-exploration
This example shows how to run the General Exploration analysis on myApplication with enabled memory bandwidth analysis:
$ amplxe-cl -collect general-exploration -knob collect-memory-bandwidth=true -- home/test/myApplicationMemory Access analysis identifies memory-related issues, like NUMA problems and bandwidth-limited accesses, and attributes performance events to memory objects (data structures), which is provided due to instrumentation of memory allocations/de-allocations and getting static/global variables from symbol information.
Use the following command line syntax to run the Memory Access analysis from the command line:
$ amplxe-cl -collect memory-access [<-knob> <knob_name=knob_option>] [--] <target>
For the most current information on available knobs (configuration options) for the Memory Access analysis, enter:
$ amplxe-cl -help collect memory-access
This example shows how to run the Memory Access analysis on myApplication and evaluate maximum achievable local DRAM bandwidth before the collection starts:
$ amplxe-cl -collect memory-access -knob dram-bandwidth-limits=true -- home/test/myApplicationSGX Hotspots analysis type uses Hardware Event-based Sampling Collection and is targeted for systems with Intel Software Guard Extensions (Intel SGX) feature enabled.
This analysis type uses the the INST_RETIRED.PREC_DIST hardware event that emulates precise clockticks and helps identify performance-critical program units inside security enclaves. Using the precise event is mandatory for the analysis on the systems with the Intel SGX enabled because regular non-precise events do not provide a correct instruction pointer and therefore cannot be attributed to correct modules.
Use the following command line syntax to run the SGX Hotspots analysis from the command line:
$ amplxe-cl -collect sgx-hotspots [<-knob> <knob_name=knob_option>] [--] <target>
For the most current information on available knobs (configuration options) for the SGX Hotspots analysis, enter:
$ amplxe-cl -help collect sgx-hotspots
The following example shoes how to run the SGX Hotspots Analysis on myApplication
$ amplxe-cl -collect sgx-hotspots -- home/test/myApplicationTSX Exploration analysis type uses event-based sampling collection and is targeted for the Intel® processors supporting Intel Transactional Synchronization Extensions (Intel TSX). This analysis type collects events that help understand Intel Transactional Synchronization Extensions behavior and causes of transactional aborts.
Use the following command line syntax to run the TSX Exploration analysis from the command line:
$ amplxe-cl -collect tsx-exploration [<-knob> <knob_name=knob_option>] [--] <target>
For the most current information on available knobs (configuration options) for the TSX Exploration analysis, enter:
$ amplxe-cl -help collect tsx-exploration
This example shows how to run the TSX Exploration analysis on myApplication with enabled user tasks analysis:
$ amplxe-cl -collect tsx-exploration -knob enable-user-tasks=true -- home/test/myApplicationTSX Hotspots analysis type uses event-based sampling collection and is targeted for the Intel® processors supporting Intel Transactional Synchronization Extensions (Intel TSX). This analysis type uses the UOPS_RETIRED.ALL_PS hardware event that emulates precise clockticks and helps identify performance-critical program units inside transactions.
Use the following command line syntax to run the TSX Hotspots analysis from the command line:
$ amplxe-cl -collect tsx-hotspots [<-knob> <knob_name=knob_option>] [--] <target>
For the most current information on available knobs (configuration options) for the TSX Hotspots analysis, enter:
$ amplxe-cl -help collect tsx-hotspots
This example shows how to run the TSX Hotspots analysis on myApplication with enabled call stacks and thread context switches advanced collection:
$ amplxe-cl -collect tsx-hotspots -knob enable-stack-collection=true -- home/test/myApplication