Application Performance Snapshot User Guide for Linux* OS

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.

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:
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