Analyze Outliers from the Command Line
To check for outliers from the command line:
Generate a summary APS report for the collected result using the command:
aps --report /<aps_result>
APS prints out the summary report with metrics relevant to your application.
If a metric has any kind of outlier, a warning message is printed next to this metric, for example:
|Some of the individual mertic values contributing to this average metric are
|statistical outliers that can significantly distort the average metric value.
To determine the exact point where an outlier occurred, print a detailed report for a specific metric using the command:
aps --report --metrics="Metric Name" /<aps_result>
APS prints a table of all individual metric values that contributed to this average metric, showing each metric value, type of outlier, and the specific node or rank, where applicable. You can use this data to troubleshoot the root cause of the outlier. For example, if a single node consistently produces outliers in several hardware metrics, there may be a hardware or software issue with this exact node.
For a full, comprehensive report on all metrics and their outliers, use:
aps --report --counters /<aps_result>