Intel® Trace Analyzer User's Reference Guide

Disclaimer and Legal Information

The information in this manual is subject to change without notice and Intel Corporation assumes no responsibility or liability for any errors or inaccuracies that may appear in this document or any software that may be provided in association with this document. This document and the software described in it are furnished under license and may only be used or copied in accordance with the terms of the license. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. The information in this document is provided in connection with Intel products and should not be construed as a commitment by Intel Corporation.

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL(R) PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER, AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.

UNLESS OTHERWISE AGREED IN WRITING BY INTEL, THE INTEL PRODUCTS ARE NOT DESIGNED NOR INTENDED FOR ANY APPLICATION IN WHICH THE FAILURE OF THE INTEL PRODUCT COULD CREATE A SITUATION WHERE PERSONAL INJURY OR DEATH MAY OCCUR.

Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of any features or instructions marked "reserved" or "undefined." Intel reserves these for future definition and shall have no responsibility whatsoever for conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with this information.

The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published specifications. Current characterized errata are available on request.

Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.

Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-548-4725, or by visiting http://www.intel.com.

Intel, Itanium, Pentium, VTune, and Xeon are trademarks of Intel Corporation in the U.S. and other countries.

* Other names and brands may be claimed as the property of others.

Copyright (c) 1996-2008, Intel Corporation. All rights reserved.

Intel® Trace Analyzer ships libraries licensed under the GNU Lesser Public License (LGPL) or Runtime General Public License. Their source code can be downloaded from ftp://ftp.ikn.intel.com/pub/opensource.


Table of Contents
1. Introduction
1.1. Notation and Terms
1.2. Starting the Intel® Trace Analyzer
1.2.1. Starting in a UNIX* Environment
1.2.2. Starting in a Windows* Environment
1.2.3. The Trace Cache
1.2.4. The Command Line Interface (CLI)
1.3. Internationalization
1.4. Online Resources
1.5. For the Impatient
2. The Main Menu
2.1. The File Menu
2.2. The Style Menu
2.3. The Windows* Menu
2.4. The Help Menu
3. Views
3.1. The View's Main Menu
3.1.1. The View Menu
3.1.2. The Charts Menu
3.1.3. The Navigate Menu
3.1.4. The Advanced Menu
3.1.5. The Layout Menu
3.1.6. The Comparison Menu
3.2. The Status Bar
3.3. Navigation In Time
3.3.1. The Zoom Stack
4. Charts
4.1. Event Timeline
4.1.1. Mouse Hover
4.1.2. Event Timeline Settings
4.1.3. The Context Menu
4.1.4. Filtering and Tagging
4.2. Qualitative Timeline
4.2.1. Mouse Hover
4.2.2. Qualitative Timeline Settings
4.2.3. Context Menu
4.2.4. Filtering and Tagging
4.3. Quantitative Timeline
4.3.1. Mouse Hover
4.3.2. Quantitative Timeline Settings
4.3.3. The Context Menu
4.3.4. Filtering and Tagging
4.4. Counter Timeline
4.4.1. Mouse Hover
4.4.2. Counter Timeline Settings
4.4.3. The Context Menu
4.4.4. Filtering and Tagging
4.5. The Function Profile Chart
4.5.1. Flat Profile
4.5.2. Load Balance
4.5.3. Call Tree
4.5.4. Call Graph
4.5.5. Using the Function Profile
4.6. The Message Profile
4.6.1. Mouse Hover
4.6.2. Message Profile Settings
4.6.3. Context Menu
4.6.4. Filtering and Tagging
4.6.5. Aggregation
4.7. The Collective Operations Profile
4.7.1. Mouse Hover
4.7.2. Collective Operations Profile Settings
4.7.3. The Context Menu
4.7.4. Filtering and Tagging
4.8. Common Chart Features
5. Dialogs
5.1. The Filtering Dialog
5.1.1. Building Filter Expressions Using the Graphical Interface
5.1.2. Building Filter Expressions Manually
5.1.3. The Filter Expression Grammar
5.1.4. Filter Expressions in Comparison Mode
5.2. The Tagging Dialog
5.3. The Process Group Editor
5.3.1. Comparison Mode
5.4. The Function Group Editor
5.4.1. Comparison Mode
5.5. The Function Group Color Editor
5.6. The Details Dialog
5.6.1. Detailed Attributes of Function Events
5.6.2. Detailed Attributes of Message Events
5.6.3. Detailed Attributes of Collective Operation Events
5.7. Source View Dialog
5.8. Time Interval Selection
5.9. The New View Dialog
5.10. The Configuration Dialogs
5.10.1. The Edit Configuration Dialog
5.10.2. The Load Configuration Dialog
5.11. The Find Dialog
5.12. Font Settings
5.13. Number Formatting Settings
6. Comparison of two Trace Files
6.1. Mappings in Comparison Views
6.1.1. Mapping of Processes
6.1.2. Mapping of Functions
6.2. Comparison Charts
6.2.1. The Comparison Function Profile
6.2.2. The Comparison Message Profile
6.2.3. The Comparison Collective Operations Profile
7. Command Line Interface (CLI)
8. Intel® Trace Collector Configuration Assistant
8.1. General Description
8.2. Detailed Description
9. Concepts
9.1. Level of Detail
9.2. Aggregation
9.2.1. Thread Aggregation
9.2.2. Function Aggregation
9.3. Tagging and Filtering
9.3.1. Tagging
9.3.2. Filtering
List of Figures
1-1. The Intel® Trace Analyzer
1-2. poisson_sendrecv.single.stf loaded
1-3. Opening an Event Timeline
1-4. Event Timeline opened
1-5. Zooming into a Chart
1-6. Zoomed result
1-7. Zoomed to one iteration
1-8. MPI ungrouped
1-9. Many Charts
1-10. One iteration of the improved version
1-11. Comparing the first iterations taken from two program runs
2-1. The File Menu
2-2. The Style Menu
2-3. The Style Menu on Windows*
2-4. The Windows* Menu
3-1. The View Menu
3-2. The Charts Menu
3-3. The Navigate Menu
3-4. The Advanced Menu
3-5. The Layout Menu
3-6. Placing timelines to the right
3-7. Zooming with the mouse
3-8. The zoom stack
3-9. State of the zoom stack - Zoomed in twice
3-10. State of the zoom stack - Moved two window sizes to the right
3-11. State of the zoom stack - after Back (B)
3-12. State of the zoom stack - after Zoom Out (O)
3-13. State of the zoom stack - after Zoom Up (U)
4-1. The Event Timeline
4-2. Settings dialog box for the Event Timeline
4-3. Event Timeline: Use Available Vertical Space unchecked
4-4. Event Timeline: Use Available Vertical Space checked
4-5. Event Timeline: context menu example
4-6. Tagging functions in a process in the Event Timeline
4-7. Filtering functions in a process in the Event Timeline
4-8. Qualitative Timeline
4-9. Status Bar when the mouse hovers over the Qualitative Timeline
4-10. The Qualitative Timeline settings dialog box
4-11. Tagging in the Qualitative Timeline
4-12. Qualitative Timeline with tagged messages
4-13. Qualitative Timeline after filtering
4-14. Quantitative Timeline without a grid
4-15. Using frames in the Quantitative Timeline
4-16. The Quantitative Timeline settings dialog box
4-17. Quantitative Timeline: context menu
4-18. Tagging the MPI_Finalize function in the Quantitative Timeline
4-19. Quantitative Timeline after filtering
4-20. The settings dialog showing all counters available in the trace with their type and scope
4-21. Some counters with differing scopes, zoomed in
4-22. Some counters with differing scopes, zoomed out
4-23. Counter Timeline Settings Dialog box
4-24. Function Profile
4-25. Ungrouping the function group MPI via the context menu
4-26. Flat Profile after ungrouping MPI
4-27. Selecting Profiles per process
4-28. Showing children of process group All Processes
4-29. Load Balance for MPI_Allreduce
4-30. Pie diagrams in the Load Balance tab
4-31. The Call Tree tab
4-32. The Call Graph tab
4-33. The Function Profile settings dialog
4-34. A context menu with a submenu
4-35. Tagged entries in the function profile
4-36. The Message Profile
4-37. The three tabs of the Message Profile settings dialog box
4-38. Grouping Volume by Receiver
4-39. Selecting an area in the matrix and zooming into
4-40. Zoomed into the selected area
4-41. Tagging a process in the Message Profile
4-42. Collective Operations Profile
4-43. Zoom to Selection in the Collective Operations Profile
4-44. Context menu of the Collective Operations Profile
4-45. Common context menu features
5-1. Function group selection opened via the filter dialog box
5-2. The filtering dialog box showing the Messages tab
5-3. The Filtering dialog box in manual mode showing its context menu
5-4. The Tagging Dialog
5-5. The Process Group Editor
5-6. The Process Group Editor's context menu
5-7. The Function Group Editor's context menu
5-8. The Function Group Color Editor
5-9. Details on Messages shown in the Qualitative Timeline
5-10. Details on Functions shown in the Event Timeline
5-11. The Source View dialog box
5-12. Selecting a time interval
5-13. The New View dialog box
5-14. The Edit Configuration Dialog
5-15. The Find dialog
5-16. Font Settings
5-17. Number Formatting Settings
6-1. A comparison View
6-2. Comparison Menu
6-3. Creating a suitable process group for the comparison between a 2 and a 4 processor run in the Process Group Editor
6-4. Comparing run A with 2 processes to run B with 4 processes
6-5. A Comparison Function Profile Chart
6-6. Undefined fields in the profile due to the chosen aggregations
6-7. The Comparison Function Profile's context menu with the available comparison operations
6-8. The Comparison Message Profile
6-9. Available Comparison Operations
6-10. The Comparison Collective Operations Profile
8-1. The Intel Trace Collector configuration assistant