User Guide

  • 12/15/2019
  • Public Content

Analyzing Applications

Prerequisites

(Optional)
Use the following software to get an advanced metric set when running Application Performance Snapshot:
  • Recommended compilers: Intel® C/C++ or Fortran Compiler (other compilers can be used, but information about OpenMP* imbalance is only available from the Intel OpenMP library)
Before running the tool, you need to set up your environment. In the terminal, run
<install-dir>
/apsvars.sh
, where
<install-dir>
is the location where Application Performance Snapshot is installed. For example:
source /opt/intel/performance_snapshots/apsvars.sh
Launch
apsvars.sh
with the
--help
option for a list of available setup options.

Analyzing Shared Memory Applications

  1. Run the following command:
    $ aps <
    my app
    > [<
    app parameters
    >]
    where
    <my app>
    is the path to your application and
    <
    app parameters
    >
    are your application parameters.
    Application Performance Snapshot launches the application and runs the data collection.
  2. After the analysis completes, a report appears in the command window. You can also open an HTML report with the same information in a supported browser. The path to the HTML report is included in the command window. For example:
    firefox ./aps_report_01012017_1234.html &
  3. Analyze the data shown in the report. Hover over a metric in the HTML report for more information.
  4. Determine appropriate next steps based on result analysis. Common next steps may include application tuning or using another performance analysis tool for more detailed information, such as
    Intel® VTune™ Profiler
    or Intel® Advisor.

Analyzing MPI Applications

  1. Run the following command to collect data about your MPI application:
    $ <
    mpi launcher
    > <
    mpi parameters
    > aps <
    my app
    > [<
    app parameters
    >]
    where:
    • <
      mpi launcher
      >
      is an MPI job launcher, such as
      mpirun
      ,
      srun
      , or
      aprun
      .
    • <
      mpi parameters
      >
      are the MPI launcher parameters.
      aps
      must be the last
      <
      mpi launcher
      >
      parameter.
    • <
      my app
      >
      is the path to your application.
    • <
      app parameters
      >
      are your application parameters.
    Application Performance Snapshot launches the application and runs the data collection. After the analysis completes, a
    aps_result
    _<date>
    directory is created.
  2. Run the following command to complete the analysis:
    $ aps --report=aps_result_<
    date
    >
    After the analysis completes, a report appears in the command window. You can also open an HTML report with the same information in a web browser.
  3. Analyze the data shown in the report. Hover over a metric in the HTML report for more information.
  4. Determine appropriate next steps based on result analysis.
    Common next steps may include communication tuning with the
    mpitune
    utility or using another performance analysis tool for more detailed information, such as Intel® Trace Analyzer and Collector or
    Intel® VTune™ Profiler
    .
Application Performance Snapshot also provides advanced capabilities for MPI analysis. See Detailed MPI Analysis for details.

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