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
Parent topic: Filtering Capabilities