User Guide

  • 2020 Update 2
  • 07/28/2020
  • Public Content

Filtering by Number of Lines

This filter enables you to see only lines of interest. Usually, these lines are the top, the bottom, and the middle ones. The filter key
-N
defines the number of lines to be shown in each part. The filter can be applied to any table chart sorted by any metric, since it works with the table lines.
The default value is five, therefore the tool displays 15 lines overall (five top lines, five middle, and five bottom lines).
Zero value disables the filter:
-N 0
. Maximum value for the filter is unlimited.
Note
By default, filter by key metric is enabled. To see independent results of the filter by number of lines, disable this filter. Use the key combination
–T 0 –V 0
, or only one of the keys, depending on sorting filter of the chart.
If you want to see only particular lines, use external text filtering tools. Application Performance Snapshot does not provide such functionality.

Examples

In all examples, the Message Size chart is used. The chart is sorted by VOLUME, so the
-V
key is used for filtering. The
-T
key does not affect the output.

Example 1

To show all lines in the chart, enter:
$ aps-report -V 0 -N 0 -m aps_result_<postfix>
For output, see Example 1 in Filtering by Key Metric.

Example 2

If you set a number larger than the table size, all lines will be displayed. For example, to display all lines of the table, enter the command:
$ aps-report -V 0 -N 1000 -m aps_result_<postfix>
For output, see Example 1 in Filtering by Key Metric.

Example 3

To apply the default filter value (five lines), enter:
$ aps-report -V 0 -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           1048576             8340          11.6789             8340           2097152             8280          11.5948             4140           4194304             8160          11.4268             2040 | [skipped 6 lines]          16777216              960          1.34433               60              4096              750          1.05026           192000              2048              375         0.525129           192000              1024            187.5         0.262565           192000               512            93.75         0.131282           192000 | [skipped 7 lines]                 2         0.308998      0.000432704           162004                 1         0.143055      0.000200326           150004                60      0.000114441     1.60257e-007                2                12     2.28882e-005     3.20513e-008                2                 0                0                0           214062 |==================================================================== | TOTAL                      71411              100          3466586

Example 4

To display two lines in the top, the middle and the bottom (six lines overall), enter:
$ aps-report -V 0 –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 11 lines]              2048              375         0.525129           192000              1024            187.5         0.262565           192000 | [skipped 11 lines]                12     2.28882e-005     3.20513e-008                2                 0                0                0           214062 |==================================================================== | TOTAL                      71411              100          3466586

Product and Performance Information

1

Intel's compilers may or may not optimize to the same degree for non-Intel microprocessors for optimizations that are not unique to Intel microprocessors. These optimizations include SSE2, SSE3, and SSSE3 instruction sets and other optimizations. Intel does not guarantee the availability, functionality, or effectiveness of any optimization on microprocessors not manufactured by Intel. Microprocessor-dependent optimizations in this product are intended for use with Intel microprocessors. Certain optimizations not specific to Intel microarchitecture are reserved for Intel microprocessors. Please refer to the applicable product User and Reference Guides for more information regarding the specific instruction sets covered by this notice.

Notice revision #20110804