An Accelerated, Handson Introduction to the VTune Performance Analyzer 2'0 for Linux

1
An Accelerated, Hands-on Introduction to the
VTune Performance Analyzer 2.0 for Linux
Jeff Gallagher Sr. Technical Consulting
Engineer Intel, Corp. February 2004
VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
2
Course Objectives

• Get help when and how you need it
• Learn to use the command line basics for sampling
  and callgraph activities
• Fine tune your collection activities by using the
  ActivityController

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
3
Course Objectives

• Installing the VTune for Linux software
• Manage the output of your sampling activities
• Automate your sampling data collection through
  scripts

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
4
Agenda

• What is the VTune Performance Analyzer 2.0 for
  Linux?
• Using the sampling collector
• Using the call graph collector
• Installing the VTune analyzer for Linux software
• Fine tuning your data collection activities
• Scripting to simplify your life

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
5
Intel Software Performance Tools
What is the VTune Performance Analyzer 2.0 for
Linux?

• Intel VTune Performance Analyzer
• Intel C, Fortran Compilers
• Performance Library Suite
• VTune Enterprise Analyzer
• Intel Software College
• Optimization Manuals
• Your Own Knowledge and Creativity!

6
Operational Environment
What is the VTune Performance Analyzer 2.0 for
Linux?

• VTune analyzer installed on the Linux server
• All activities occur on that server
• Data collection
• Data analysis
• Data display (character-based)
• Data appears to stdout (the display) but can be
  redirected into files or databases of your choice
• There is a GUI for callgraph only, currently

Intel, Itanium, VTune, and the intel logo are
trademarks or registered trademarks of Intel
Corporation or its subsidiaries in the United
States or other countries.
7
Supported Linux environments
What is the VTune Performance Analyzer 2.0 for
Linux?

• Hardware requirements
• An Intel IA-32based processor system
• An Intel Itanium-based processor system
• Software requirements
• A supported Red Hat or SuSE operating system
• As always, examine the release notes for a
  detailed listing

Intel, Itanium, and the Intel logo are trademarks
or registered trademarks of Intel Corporation or
its subsidiaries in the United States or other
countries.
8
Brief Theory of Operation
What is the VTune Performance Analyzer 2.0 for
Linux?

• Single server solution
• EntireX software
• From SAG, creates a DCOM layer
• Shows up as multiple instances of
• /opt/sag/exx/v611/bin/rpcss
• /opt/sag/exx/v611/bin/paulad -lo
• The VTune analyzer drivers
• The vtl command
• User invokes from command line, or runs script
  to generate activities
• Two step process collect data, then view it
• Logically, three steps configure, collect, view

9
Feature Overview
What is the VTune Performance Analyzer 2.0 for
Linux?

• Sampling
• Callgraph
• Available Help
• Command line help vtl -help
• man pages
• man vtl
• man sampling
• man callgraph
• man ActivityController (note upper case A and C)
• man 7 code
• User Guide, Reference Manual, Getting Started
• Optional Pack and Go to VTune 7.1

Intel and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
10
Command Line Methodology
What is the VTune Performance Analyzer 2.0 for
Linux?

• Two-step approach
• Collect as much data as you can
• View the data through the filter that most
  interests you
• Many users prefer to import the collection data
  into a database for viewing

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
11
Demo the vtl Command
What is the VTune Performance Analyzer 2.0 for
Linux?

• vtl ltcommand command optionsgt
• vtl basic,
  required
• vtl help list out
  the command help
• vtl help c sampling list supported
  processor events
• vtl version list the
  software version
• vtl query lc list the
  installed collectors
• vtl show show me the
  hidden project
• vtl show a show all
  details
• vtl delete ltactivitygt delete a specific
  activity
• vtl delete a8
• vtl delete delete the last activity

12
Man pages
What is the VTune Performance Analyzer 2.0 for
Linux?

• man vtl
• man ActivityController
• man callgraph
• man sampling
• man 7 code

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
13
Documentation
What is the VTune Performance Analyzer 2.0 for
Linux?

• User Guide
• Reference Manual
• Getting Started Guide

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
14
Lab 1 Getting Help
Learn the kind of help that is available, and
when it can be of the most use to you
VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
15

What is the VTune Performance Analyzer 2.0 for
Linux?

• Getting help is easy if you know where to look.

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
16
Agenda

• What is the VTune Performance Analyzer 2.0 for
  Linux?
• Using the sampling collector
• Using the call graph collector
• Installing the VTune analyzer for Linux software
• Fine tuning your data collection activities
• Scripting

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
17
Example Sampling Command
Using the Sampling Collector

• vtl activity c sampling app nbench run

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
18
Sampling Collects System Wide Performance
Data Example of a successful run output Default
Instructions Retired and Clockticks
VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
19
Finding the hotspots
Using the Sampling Collector
VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
20
Drilling down to source
Using the Sampling Collector
VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
21
Lab 2 Sampling Overview
Learn how to identify hotspots with the VTune
analyzer
VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
22

Using the Sampling Collector

• The sampling collector is a non-intrusive way to
  analyze your code.

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
23
Agenda

• What is the VTune Performance Analyzer 2.0 for
  Linux?
• Using the sampling collector
• Using the call graph collector
• Installing the VTune analyzer for Linux software
• Fine tuning your data collection activities
• Scripting

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
24
Now For the Fun Part (Call Graph!)
Using the Call Graph Collector

• Overview window
• Wait Times
• Highlight critical path functions
• Focus Function caller callee analysis

vtl activity idf c callgraph app
/usr/bin/gzip moi /usr/bin/gzip
Other names and brands may be claimed as the
property of others
25
Example Callgraph Command
Using the Call Graph Collector

• vtl activity c callgraph app myob moi myob
  run

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
26
The callgraph viewer
plugin GUI (-gui option)
Using the Call Graph Collector
VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
27
Lab 3 Callgraph overview
Use callgraph to determine the flow of control of
your application
The Intel logo is a trademark or registered
trademark of Intel Corporation or its
subsidiaries in the United States or other
countries.
28

Using the Call Graph Collector

• Use callgraph to determine the flow of control in
  your application.

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
29
Agenda

• What is the VTune Performance Analyzer 2.0 for
  Linux?
• Using the sampling collector
• Using the call graph collector
• Installing the VTune analyzer for Linux software
• Fine tuning your data collection activities
• Scripting

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
30
Installation
Installing the VTune Analyzer for Linux Software

• You must be logged in as root to install (or know
  the root password)
• If you must su, be sure to use su
• Uninstall any previous version (beta, for
  example)
• Default installation tree /opt/intel/vtune
• Which of the following would you like to
  install?
• 1. All VTune(TM) Performance Analyzer 2.0 for
  Linux components (installs 2-4)
• 2. EntireX DCOM for Linux (required by the VTune
  analyzer)
• 3. Kernel drivers (required by the VTune
  analyzer)
• 4. VTune Performance Analyzer 2.0 for Linux
• x. Quit this install

31
The Install log
Installing the VTune Analyzer for Linux Software

• Very cool installation log that shows all
  decisions, successes and failures, with time
  stamp
• Filename install.log is created in the directory
  that root starts the installation in. Partial
  sample
• Thu 11 145112 Success - User chose the all
  components installation.
• Thu 11 145118 Success - User chose to accept
  the EULA file for installing the product.
• Thu 11 145129 Success - Test for required
  hardware and software - done.
• Thu 11 145129 Success - EntireX DCOM for Linux
  is installing into /opt/sag directory
• Thu 11 145130 Success - Installation of the
  dcom-license-v6.1.1-3.i586.rpm
• Thu 11 145158 Success - Installation of the
  dcom-v6.1.1-3.i586.rpm
• Thu 11 145211 Success - Installation of the
  intel-entirex-patch-1.0-139.x32.rpm.
• Thu 11 145211 Success - EntireX DCOM for Linux
  was successfully installed.
• Thu 11 145221 Success - User choice of "vtune"
  was accepted.
• Thu 11 145221 Success - Install destination set
  to /opt/intel/vtune
• Thu 11 145231 Success - User choice of install
  options "-U --replacefiles" was accepted.
• Thu 11 145232 Success - Installation of the
  intel-vtune-cli-drivers-1.0b-139.x32.rpm.
• Thu 11 145232 Success - The kernel drivers for
  the VTune analyzer were successfully installed.

32
Agenda

• What is the VTune Performance Analyzer 2.0 for
  Linux?
• Using the sampling collector
• Using the call graph collector
• Installing the VTune analyzer for Linux software
• Fine tuning your data collection activities
• Controlling output
• Scripting

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
33
The ActivityController
Fine Tuning Your Data Collection Activities

• Comes with the software
• Allows you to stop, cancel, pause, and resume
  activities, as well as obtain activity status and
  information

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
34
Lab 4 ActivityController
Learn how to fine tune your data collection
activities
The Intel logo is a trademark or registered
trademark of Intel Corporation or its
subsidiaries in the United States or other
countries.
35

Fine Tuning Your Data Collection Activities

• The ActivityController is the right way to do
  things.

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
36
Agenda

• What is the VTune Performance Analyzer 2.0 for
  Linux?
• Using the sampling collector
• Using the call graph collector
• Installing the VTune analyzer for Linux software
• Fine tuning your data collection activities
• Controlling output
• Scripting

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
37
Lab 5 Controlling output
Learn the basics of how to get the most out of
your command line collection and viewing
activities
The Intel logo is a trademark or registered
trademark of Intel Corporation or its
subsidiaries in the United States or other
countries.
38

Controlling Output

• Use vtl options and the Linux shell to view the
  data you care about most.

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
39
Scripting your activities
Scripting

• Your favorites are supported
• Perl
• Shell (Bourne, Korn, C, bash, etc.)
• Typically scripts contain data collection and
  data manipulation, and data viewing statements

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
40
Lab 6 Scripting
Learn the basics of how to get the most out of
your command line collection and viewing
activities
The Intel logo is a trademark or registered
trademark of Intel Corporation or its
subsidiaries in the United States or other
countries.
41

Scripting

• Even if you love to type, scripting is a way of
  life in Linux

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
42

Key Point Summary

• Getting help is easy if you know where to look.
• The sampling collector is a non-intrusive way to
  analyze your code.
• Use callgraph to determine the flow of control in
  your application.
• The ActivityController is the right way to do
  things.
• Use vtl options and the Linux shell to view the
  data you care about most.
• Even if you love to type, scripting is a way of
  life in Linux

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
43
How to Get the VTune Performance Analyzer 2.0
for Linux

• Free evaluation download
• http//www.intel.com/software/products/vtune/vlin/
  
• Purchasing information
• http//www.intel.com/software/products/vtune/vlin/

Intel, Vtune, and Xscale are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
44
Registration and Licensing

• You must register and receive a license key
  before you can install the VTune Performance
  Analyzer 2.0 for Linux
• How to get a license key
• The registration center
• Register for support at time of purchase or
  download
• Receive product license key
• Comes with CDROM
• Evaluation licenses, currently 7 days from the
  day it is emailed to you

VTune and the Intel logo are trademarks or
registered trademarks of Intel Corporation or its
subsidiaries in the United States or other
countries.
45
Thank You!

• VTune Performance Analyzer Discussion Forums
• http//intel.forums.liveworld.com/forum.jsp?forum
  136
• Please complete your session evaluation
• Dont forget ISC!

Intel, VTune, and the Intel logo are trademarks
or registered trademarks of Intel Corporation or
its subsidiaries in the United States or other
countries.