ARM Performance Reports is a simple tool used to generate a single-page HTML or plain text report that presents the overall performance characteristics of HPC applications. It supports pthreads, OpenMP, or MPI code on CPU, GPU, and MIC based architectures.
Availability and Restrictions
The versions currently available at OSC are:
You can use
module spider arm-pr to view available modules for a given machine. Feel free to contact OSC Help if you need other versions for your work.
ARM Performance Reports is available to all OSC users. We have 64 seats with 64 HPC tokens. Users can monitor the license status here.
To load the module for the ARM Performance Reports default version, use
module load arm-pr. To select a particular software version, use
module load arm-pr/version. For example, use
module load arm-pr/6.0 to load ARM Performance Reports version 6.0, provided the version is available on the OSC cluster in use.
Using ARM Performance Reports
You can use your regular executables to generate performance reports. The program can be used to analyze third-party code as well as code you develop yourself. Performance reports are normally generated in a batch job.
To generate a performance report for an MPI program:
module load arm-pr perf-report -np <num procs> --mpiargs="<mpi args>" <program> <program args>
<num procs> is the number of MPI processes to use,
<mpi args> represents arguments to be passed to mpiexec (other than -n or -np),
<program> is the executable to be run and
<program args> represents arguments passed to your program.
For example, if you normally run your program with
mpiexec -n 12 wave_c, you would use
perf-report -np 12 wave_c
To generate a performance report for a non-MPI program:
module load arm-pr perf-report --no-mpi <program> <program args>
The performance report is created in both html and plain text formats. The file names are based on the executable name, number of processes, date and time, for example,
wave_c_12p_2016-02-05_12-46.html. To open the report in html format use
For more details, download the ARM Performance Reports User Guide.
Performance Reports with GPU
ARM Performance Reports can be used for CUDA codes. If you have an executable compiled with the CUDA library, you can launch ARM Performance Reports with
For more information, please read the section 6.10 of the ARM Performance Reports User Guide.