Intel® VTune™ Profiler

Cookbook

Download PDF
ID 766316
Date 6/24/2024
Public

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

Document Table of Contents
Document Table of Contents x
Cookbook
Cookbook x
Methodologies Configuration Recipes Tuning Recipes Notices and Disclaimers
Methodologies x
Analyzing Uncore Perfmon Events for Use of Intel® Data Direct I/O Technology in Intel® Xeon® Processors (NEW) Top-down Microarchitecture Analysis Method OpenMP* Code Analysis Method Custom Data Collection for Performance Analysis (NEW) Software Optimization for Intel® GPUs (NEW) Core Utilization in DPDK Apps PCIe Traffic in DPDK Apps DPDK Event Device Profiling Effective Utilization of Intel® Data Direct I/O Technology Compile a Portable Optimized Binary with the Latest Instruction Set
Configuration Recipes x
Profiling OpenVINO™ Applications (NEW) Profiling High Bandwidth Memory Performance on Intel® Xeon® CPU Max Series (NEW) Profiling Windows* Applications for Hybrid CPU Platforms (NEW) Viewing Analysis Results on a Web Browser (NEW) Profiling Data Parallel Python* Applications (NEW) Profiling Single-Node Kubernetes* Applications (NEW) Analyzing Hot Code Paths Using Flame Graphs (NEW) Improving Hotspot Observability in a C++ Application Using Flame Graphs Profiling Games built with Unity* (NEW) Profiling Games built with Unreal Engine* (NEW) Profiling Java Applications as a Remote User (NEW) Profiling JavaScript* Code in Node.js* Analyzing CPU and FPGA (Intel® Arria® 10 GX) Interaction Profiling a .NET* Core Application Profiling Applications in Amazon Web Services* (AWS) EC2 Instances Enabling Performance Profiling in GitLab* CI Configuring a Hyper-V* Virtual Machine for Hardware-Based Hotspots Analysis Ingredients Configure a Hyper-V Host Create and Configure a Virtual Machine Configure the Virtual Machine for the Hardware Analysis Run Hotspots Analysis See Also Profiling an Application for Performance Anomalies (NEW) Profiling an OpenMP* Offload Application running on a GPU Profiling a SYCL* Application running on a GPU Profiling an FPGA-driven SYCL* Application Profiling Hardware Without Intel Sampling Drivers Profiling MPI Applications Profiling Docker* Containers Profiling a Remote Target Through a Proxy Server (NEW) Profiling in an Apptainer* Container Profiling Linux*, Android*, and QNX* System Boot Time Using Intel® VTune™ Profiler Server with Visual Studio Code and Intel® DevCloud for oneAPI (NEW) Using Intel® VTune™ Profiler Server in HPC Clusters Using the Command-Line Interface to Analyze the Performance of a SYCL* Application running on a GPU (NEW)
Tuning Recipes x
Cache-Related Latency Issues in Segmented Cache Environment False Sharing Frequent DRAM Accesses Poor Port Utilization Page Faults Instruction Cache Misses OS Thread Migration OpenMP* Imbalance and Scheduling Overhead Processor Cores Underutilization: OpenMP* Serial Time Scheduling Overhead in an Intel® oneAPI Threading Building Blocks Application PMDK Application Overhead
Cookbook

Configuring a Hyper-V* Virtual Machine for Hardware-Based Hotspots Analysis

This recipe helps you set up a Virtual Machine instance in the Hyper-V environment for hardware performance profiling with Intel® VTune™ Profiler.

Ingredients

This section lists the hardware and software tools used for the performance analysis scenario.

  • Tools:

    • Intel® VTune™ Profiler (or any release of the Intel® VTune™ Amplifier 2019)

      NOTE:

      • Starting with the 2020 release, Intel® VTune™ Amplifier has been renamed to Intel® VTune™ Profiler.

      • Most recipes in the Intel® VTune™ Profiler Performance Analysis Cookbook are flexible. You can apply them to different versions of Intel® VTune™ Profiler. In some cases, minor adjustments may be required.

      • Get the latest version of Intel® VTune™ Profiler:

    • A third-party virtual machine manager (VMM) may also be required.

  • CPU: Intel® Xeon® processor that supports Intel® Virtualization Technology (Intel® VT)

    You can also use any Intel microarchitecture with performance monitoring hardware, such as:

    Intel Microarchitecture code name

    PMU Version

    PEBS

    LBR

    IPT

    PT2GPA

    Kaby Lake

    4

    Yes

    Yes

    Yes

    No

    Ice Lake

    4

    Yes

    Yes

    Yes

    Yes

    Cascade Lake

    4

    Yes

    Yes

    Yes

    No

    Gemini Lake

    4

    Yes

    Yes

    Yes

    No

    Skylake

    4

    Yes

    Yes

    No

    No

    Haswell

    3

    Yes

    Yes

    No

    No

    Broadwell

    3

    Yes

    Yes

    No

    No

  • Operating system: Microsoft* Windows Server 2019 or Windows 10 Version 1809 (October 2018 Update) or later

  • BIOS with Intel VT support

NOTE:
Hyper-V may impose additional requirements described in the Enable Intel Performance Monitoring Hardware in a Hyper-V virtual machine

article.

Configure a Hyper-V Host

  1. Enable the Intel VT in the BIOS setup on your server:

    1. Access the system BIOS by pressing F2 during the system power-on self test (POST).
    2. Click Advanced > Processor Configuration.

    3. Select Intel® Virtualization Technology and change to Enabled.

    4. Do an AC power cycle for changes to take effect.

  2. Go to Control Panel > Programs > Programs and Features and click Turn Windows features on or off on the left pane.

    The Windows Features dialog box opens.

  3. Expand the Hyper-V feature and select all the check boxes:

  4. Click OK and proceed with the installation.

    When the installation is complete, click Restart now.

Create and Configure a Virtual Machine

On your Hyper-V host (further, host), run Hyper-V Manager from the Start menu to create and configure a new VM (further, VM):

  1. From the Actions panel, click New and select Virtual Machine... :

  2. In the New Virtual Machine Wizard, specify all necessary parameters for the new machine (CPU configuration, Memory, Network, Hard Disk, and others).

    Recommended system requirements for the VTune Profiler are 4 GB RAM and at least 10 GB free disk space.

  3. Configure your installation source. For example, you can use local installation .iso image:

  4. Start the newly created VM and proceed with the OS installation process.

Configure the Virtual Machine for the Hardware Analysis

Prepare a target system instance for profiling by exposing PMU/PEBS/LBR to the VM:

  1. Turn off the newly created VM and launch your host Windows PowerShell as an Administrator from the Start menu.

  2. In the PowerShell, configure your VM to expose PMU, PEBS, LBR to the VM as follows: 

    Set-VMProcessor -VMName your_vm_name -Perfmon pmu,pebs,lbr

  3. Turn on your VM.

NOTE:
For additional guidance, see the Enable Intel Performance Monitoring Hardware in a Hyper-V virtual machine article.

Run Hotspots Analysis

Run the VTune Profiler directly from the VM:

  1. Install the VTune Profiler on the VM.

  2. Run the VTune Profiler from Start menu.

  3. Create a project.

    The Configure Analysis window opens.

  4. On the WHERE pane, select Local Host.

  5. On the WHAT pane, specify the location of your application and its working directory.

  6. On the HOW pane, select the Hardware Event-Based Sampling collection mode for the Hotspots analysis.

    If you succeed with exposing PMU/PEBS/LBR, your analysis configuration pane will show no error messages and you will be able to perform the analysis.

  7. Click Start to run the analysis.

    The analysis result opens in the default Hotspots by CPU Utilization viewpoint.

NOTE:

You may perform the Hotspots analysis in multiple VMs running simultaneously.

Parent topic: Configuration Recipes
Level Two Title