AMD uProf User Guide Advanced Micro Devices AMD uProf User Guide © 2019 Advanced Micro Devices, Inc. All rights reserved. The information contained herein is for informational purposes only, and is subject to change without notice. While every precaution has been taken in the preparation of this document, it may contain technical inaccuracies, omissions and typographical errors, and AMD is under no obligation to update or otherwise correct this information. Advanced Micro Devices, Inc. makes no representations or warranties with respect to the accuracy or completeness of the contents of this document, and assumes no liability of any kind, including the implied warranties of noninfringement, merchantability or fitness for particular purposes, with respect to the operation or use of AMD hardware, software or other products described herein. No license, including implied or arising by estoppel, to any intellectual property rights is granted by this document. Terms and limitations applicable to the purchase or use of AMD’s products are as set forth in a signed agreement between the parties or in AMD's Standard Terms and Conditions of Sale. Trademarks AMD, the AMD Arrow logo, and combinations thereof are trademarks of Advanced Micro Devices, Inc. Microsoft, Windows, Windows 10 are registered trademarks of Microsoft Corporation. MMX is a trademark of Intel Corporation. PCIe is a registered trademark of PCI-Special Interest Group (PCI-SIG). Other product names used in this publication are for identification purposes only and may be trademarks of their respective companies. AMD uProf User Guide Contents About this document ........................................................................................................................ 6 Chapter 1 Introduction .............................................................................................................. 9 1.1 Overview ............................................................................................................................ 9 1.2 Specifications ................................................................................................................... 10 1.3 Installing uProf ................................................................................................................ 11 1.3.1 Installing Power Profiling driver on Linux .............................................................. 11 1.3.2 Installing Remote Agent .......................................................................................... 13 1.3.3 Sample program ....................................................................................................... 13 1.4 Support ............................................................................................................................. 13 Chapter 2 Workflow and Key concepts ................................................................................. 14 2.1 Workflow ......................................................................................................................... 14 2.1.1 Collect phase ............................................................................................................ 14 2.1.2 Translate phase......................................................................................................... 16 2.1.3 Analyze phase .......................................................................................................... 16 2.2 Predefined Sampling Configuration ................................................................................ 17 2.3 Predefined View Configuration ....................................................................................... 18 Chapter 3 Getting started with AMDuProf GUI .................................................................. 22 3.1 User Interface ................................................................................................................... 22 3.2 Launching GUI ................................................................................................................ 23 3.3 Configure a profile ........................................................................................................... 24 3.3.1 Select Profile Target ................................................................................................ 24 3.3.2 Select Profile Type ................................................................................................... 26 3.3.3 Start Profile .............................................................................................................. 27 3.4 Analyze the profile data ................................................................................................... 28 3.4.1 Hot Spots .................................................................................................................. 28 3.4.2 Process and Functions .............................................................................................. 29 3.4.3 Source and Assembly ............................................................................................... 31 3.4.4 Timechart ................................................................................................................. 32 3.5 Importing Profile Databases ............................................................................................ 33 3 AMD uProf User Guide 3.6 Analyzing saved Profile Session ..................................................................................... 34 3.7 Using saved Profile Configuration .................................................................................. 35 3.8 Settings ............................................................................................................................ 36 Chapter 4 Getting started with AMDuProfCLI ................................................................... 37 4.1 How to start CPU profile? ............................................................................................... 37 4.2 How to start Power profile? ............................................................................................ 40 4.3 Collect command............................................................................................................. 41 4.4 Report command ............................................................................................................. 46 4.5 Timechart command ........................................................................................................ 49 4.6 Info command ................................................................................................................. 52 Chapter 5 Performance Analysis ........................................................................................... 53 5.1 Analysis with Time-based profiling ................................................................................ 54 5.2 Analysis with Event based profiling ............................................................................... 58 5.3 Analysis with Instruction based sampling ....................................................................... 62 5.4 Analysis with Callstack samples ..................................................................................... 65 5.4.1 Flame graph ............................................................................................................. 66 5.4.2 Call graph ................................................................................................................ 67 5.5 Thread Concurrency ........................................................................................................ 68 5.6 Profiling a Java Application ............................................................................................ 70 5.7 Profiling Linux System Modules .................................................................................... 71 5.8 Profiling Linux Kernel .................................................................................................... 72 5.9 Limitations ...................................................................................................................... 72 Chapter 6 System Analysis ..................................................................................................... 73 6.1 Metrics ............................................................................................................................. 73 6.2 Profile using GUI ............................................................................................................ 76 6.2.1 Configure ................................................................................................................. 76 6.2.2 Analyze .................................................................................................................... 78 6.2.3 Settings .................................................................................................................... 79 6.3 Profile using CLI ............................................................................................................. 79 6.3.1 Examples ................................................................................................................. 80 6.4 AMDPowerProfileAPI Library ....................................................................................... 81 6.4.1 How to use the APIs? .............................................................................................. 81 4 AMD uProf User Guide