Application Performance Snapshot User Guide for Linux* OS

Download PDF
ID 772048
Date 12/16/2022
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
Application Performance Snapshot User's Guide for Linux* OS
Application Performance Snapshot User's Guide for Linux* OS x
Introducing Application Performance Snapshot Analyzing Applications Detailed Analyses Metrics Reference Known Issues and Limitations Notices and Disclaimers
Analyzing Applications x
Controlling Amount of Collected Data
Detailed Analyses x
Common Analyses MPI Analyses Outlier Detection
MPI Analyses x
Analysis Charts Filtering Capabilities Region Control with MPI_Pcontrol Creating Configuration File for Intel® Trace Collector
Analysis Charts x
Function Summary for All Ranks MPI Time per Rank Message Sizes Summary for All Ranks Data Transfers per Rank-to-Rank Communication Data Transfers per Rank Data Transfers per Function Node-to-Node Data Transfers Communicator List Detailed Information for Specific Ranks
Filtering Capabilities x
Filtering by Key Metric Filtering by Number of Lines Using Filter Combinations Examples Example 1 Example 2
Application Performance Snapshot User's Guide for Linux* OS

Using Filter Combinations

By default, both filters described above are enabled. The default threshold for TIME and VOLUME is 1%, default value for the number of lines filter is five. Thus, the default tool behavior is the same as with the key combination -V 1 -T 1 -N 5.

NOTE:
Note

Filter by key metric is applied first. Filtering by number of lines filters only the remaining lines.

Examples

In all the examples, the Message Size chart containing 28 lines is used.

Example 1

To use the default options, enter: 

$ aps-report -m aps_result_<postfix>

This command line is equal to this one: 

$ aps-report -m -V 1 -T 1 -N 5 aps_result_<postfix>

Output: 

| Message Sizes summary for all ranks
|--------------------------------------------------------------------
| Message size(B)       Volume(MB)        Volume(%)        Transfers
|--------------------------------------------------------------------
           262144             8340          11.6789            33360
           524288             8340          11.6789            16680
          1048576             8340          11.6789             8340
          2097152             8280          11.5948             4140
          4194304             8160          11.4268             2040
           131072             8130          11.3848            65040
            65536             7650          10.7126           122400
            32768             5805            8.129           185760
            16384          2966.25          4.15377           189840
             8192             1500          2.10052           192000
          8388608             1440           2.0165              180
         16777216              960          1.34433               60
             4096              750          1.05026           192000
| [skipped 15 lines]
|====================================================================
| TOTAL                      71411              100          3466586

The volume filter hides the bottom lines with Volume(%) less than 1% (15 lines). The remaining 13 lines are less than the number of lines to be displayed. Therefore, the filter by number of lines will not be applied.

Example 2

To hide the lines with VOLUME less than 1% (default threshold), and display two top lines, two middle lines, and two bottom lines of the remaining lines, enter: 

$ aps-report -N 2 -m aps_result_<postfix>

or 

$ aps-report -V 1-N 2 -m aps_result_<postfix>

Output: 

| Message Sizes summary for all ranks
|--------------------------------------------------------------------
| Message size(B)       Volume(MB)        Volume(%)        Transfers
|--------------------------------------------------------------------
           262144             8340          11.6789            33360
           524288             8340          11.6789            16680
| [skipped 3 lines]
           131072             8130          11.3848            65040
            65536             7650          10.7126           122400
| [skipped 4 lines]
         16777216              960          1.34433               60
             4096              750          1.05026           192000
| [skipped 15 lines]
|====================================================================
| TOTAL                      71411              100          3466586
Parent topic: Filtering Capabilities
Level Two Title