This page was translated by an AI (LLM) with a cursory human check and is awaiting full review.
Performance Reports
We invite you to consult the best practices for code profiling for general advice on performance analysis on Jean Zay.
Description
ARM Performance Reports is a performance analysis tool. Sampling is done very simply on the command line and produces result files in various formats (text, HTML).
Compilation
Your program must be compiled with the options -g -O3 of the Intel and GNU compilers or -gopt of the NVIDIA compilers. These options instruct the compiler to add various information to the executable that will allow displaying the source code line numbers, variable names, etc., while maintaining a high level of optimisation.
For more information, you can consult the detailed list of Intel compiler debugging options.
Usage
The module command provides access to the various versions of Performance Reports:
$ module avail arm-forge
arm-forge/19.1.1 arm-forge/20.1.2 arm-forge/20.2.1
To use the version 20.2.1, simply use the following command:
$ module load arm-forge/20.2.1
Once the module is loaded, using Performance Reports is done in two steps:
- Running your program with
perf-report; - Viewing the diagnostics.
Execution
Execution is done either interactively or in batch mode, via the perf-report command:
$ module load arm-forge/20.2.1
$ perf-report srun my_exe
Viewing Results
Performance Reports writes an HTML file and a text file at the end of the program execution.