User Guide

Intel® VTune™ Profiler User Guide

ID 766319
Date 11/07/2023
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of Contents

trace-mpi

For message passing interface (MPI) analysis , configure collectors to determine MPI rank ID in case of a non-Intel MPI library implementation.

Syntax

-trace-mpi | -no-trace-mpi

Default

-no-trace-mpi

Actions Modified

collect, collect-with

Description

Based on the PMI_RANK or PMI_ID MPI analysis environment variable (whichever is set), the VTune Profiler extends a process name with the captured rank number that is helpful to differentiate ranks in a VTune Profiler result with multiple ranks. The process naming schema in this case is <process_name> (rank <N>). Use the -trace-mpi option to enable detecting an MPI rank ID for MPI implementations that do not provide the environment variable.

Examples

This command runs the Hotspots analysis type (hardware event-based sampling mode) with enabled MPI rank ID detection.

mpirun -n 4 vtune -result-dir my_result -trace-mpi -collect hotspots -knob sampling-mode=hw -- ./test.x