Parallelism - MPI Trace Analysis - Parallelism - MPI Trace Analysis - 57368

uProf User Guide
Document ID
57368
Release Date
2025-06-09
Revision
5.1 English

MPI trace analysis can be used to analyze, and compute the message passing load imbalance among the ranks of a MPI application running on a cluster. It supports OpenMPI, MPICH, and their derivatives.

The supported thread models are MPI_THREAD_SINGLE, MPI_THREAD_FUNNLED, and MPI_THREAD_SERIALIZED. The profile reports are generated for Point-to-Point and Collective API activity summary.

Fortran bindings are configured and built while compiling the MPI implementations. You can enable/ disable the Fortran bindings based on your need for Fortran language support.

Refer the following options to disable/enable the Fortran bindings:
  • OpenMPI
    --enable-mpi-fortran[=VALUE]
--disable-mpi-fortran

    By default, OpenMPI will attempt to build all the 3 Fortran bindings: mpif.h, mpi module, and mpi_f08 module.

  • MPICH
    --disable-fortran

    By default, the Fortran bindings are enabled. You can use this option to disable it.

Support Matrix

Table 1. Support Matrix
Component Supported Versions
MPI Spec MPI v3.1 or later
MPI Libraries
  • Open MPI v4.14
  • Open MPI v5.0
  • MPICH v4.0.3
  • MPICH v4.2
  • ParaStation MPI v5.6.0
  • Intel® MPI 2021.1
OS
  • Ubuntu: 18.04 LTS, 20.04 LTS, 22.04.04 LTS, and Ubuntu 24.04
  • RHEL: 8.6 and 9
  • CentOS 8.4
Languages C, C++, and Fortran

MPI Implementation Support

AMD uProf supports tracing of Open MPI and MPICH and the derivatives:

  • --trace mpi --mpi-impl mpich for MPICH and derivatives (default option)
  • --trace mpi --mpi-impl openmpi for Open MPI

Ensure that the correct option (mpich or openmpi) is passed depending on the MPI implementation used for compiling the MPI application. Passing incorrect option might cause undefined behavior.

Tracing Modes

The AMDuProf CLI supports the following 2 modes for MPI tracing:

  • LWT – Light-weight tracing is useful for quick analysis of an application. The report gets generated in .csv format on-the-fly during collection stage. Use CLI option --mpi-scope lwt for LWT mode.
  • FULL – Full tracing is useful for in-depth analysis. This mode requires post-processing for report generation in .csv format. Use CLI option --mpi-scope full for FULL mode.

For more information on MPI tracing options, see Linux Specific Options .