moved to https://docs.hpc.taltech.ee not changed to rocky yet

Profiling

Is the skill and art of finding which part of your code needs the most time, and therefore to find the place where you can (should, need to) optimize (first). The optimization can be different things, like using library functions instead of self-written ones, re-arranging memory access, removing function calls, writing C/Fortran functions for your Python code.

The profiling can be done manually by adding time and print statements to your code or (better) by using tools like Valgrind, TAU, HPCToolkit, Score-P or Python’s Scalene or cProfile.

Tools to profile applications and perform efficiency, scaling and energy analysis are described in this document by the Virtual Institute High Performance Computing: https://www.vi-hps.org/cms/upload/material/general/ToolsGuide.pdf




Monitoring jobs on the node


It is possible to submit a second (this time) interactive job to the node where the main job is running, check with squeue where your job is running, then submit

srun -w <nodename> --pty htop

Note that there must be free slots on the machine, so you cannot use -n 80 or --exclusive for your main job (use -n 79).

Alternative method if you have X11, e.g. on Linux computers:

When you login to base/amp, use ssh -X UniID@base.hpc.taltech.ee,

then submit your main job with srun --x11 -n <numtasks> --cpus-per-task=<numthreads> --pty bash and start an xterm -e htop &` in the session.

In sbatch the option --x11=batch can be used, note that the ssh session to base needs to stay open!




Valgrind


Manual: http://valgrind.org/docs/manual/manual.html

Valgrind is an instrumentation framework for building dynamic analysis tools. There are Valgrind tools that can automatically detect many memory management and threading bugs, and profile your programs in detail. You can also use Valgrind to build new tools.

The Valgrind distribution currently includes seven production-quality tools: a memory error detector, two thread error detectors, a cache and branch-prediction profiler, a call-graph generating cache and branch-prediction profiler, and two different heap profilers. It also includes an experimental SimPoint basic block vector generator.

Callgrind

Cachegrind




Profiling Python


Python is very slow, the best improvement is achieved by rewriting (parts of) the program in Fortran or C. See also “Python Performance Matters” by Emery Berger (Strange Loop 2022) https://www.youtube.com/watch?v=vVUnCXKuNOg

Python Scalene

Scalene is a CPU, GPU and memory profiler for Python that is very performant (introduces very little overhead).

Installation: load your favourite Python module, e.g.

module load green-spack
module load python/3.8.7-gcc-10.3.0-plhb
py-pip/21.1.2-gcc-10.3.0-python-3.8.7-bj7d

then install using pip:

python -m pip install --user scalene

Homepage and quickstart: https://github.com/plasma-umass/scalene

Python cProfile




perf


https://perf.wiki.kernel.org/index.php/Main_Page

perf is powerful: it can instrument CPU performance counters, tracepoints, kprobes, and uprobes (dynamic tracing). It is capable of lightweight profiling. It is also included in the Linux kernel, under tools/perf, and is frequently updated and enhanced.

perf began as a tool for using the performance counters subsystem in Linux, and has had various enhancements to add tracing capabilities.




TAU, Jumpshot, Paraprof


TAU can be used for profiling and for MPI tracing (not at the same time, though). See e.g. https://wiki.mpich.org/mpich/index.php/TAU_by_example

Load the spack TAU module:

module load green-spack
module load tau/2.30.2-gcc-10.3.0-2wge

Profiling

TAU supports different methods of instrumentation:

- Dynamic: statistical sampling of a binary through preloading of libraries
- Source: parser-aided automatic instrumentation at compile time
- Selective: a subcategory of source, it is automatic, but guided source code instrumentation

The simplest and only for existing binary software is dynamic profiling through tau_exec, just run

srun tau_exec your_program

several profile.* files will be created. This method can unfortunately only profile MPI functions and not user-defined ones. Note, that profile files are only generated if the program exits normally, not if an error occurs or SLURM kills it!

You can generate reports with pprof and visualize with paraprof.

MPI tracing

The tracing can take a lot of space, it is not uncommon that tracefiles are several GB in size for each MPI-task!

export TAU_TRACE=1
srun  -n 2 tau_exec ./pingpong-lg-mpi4
tau_treemerge.pl

TAU does not have a tracing visualizer, but provides tools to convert its traces to other formats, e.g. slog2 for jumpshot, otf(2) or paraver:

tau2slog2 tau.trc tau.edf -o tau.slog2
tau_convert -paraver tau.trc tau.edf trace.prv

The traces can be visualized using jumpshot (in the tau module), just run

jumpshot tau.slog2

jumpshot may open a huge window (larger than screen size), in this case use the “maximize” option of your window manager (fvwm: in the left window corner menu), jumpshot opens 3 windows: “jumpshot-4”, “Legend” and “Timeline” (if you cannof find them, use window manager menu, e.g. fvwm: right mouse button on desktop background).




EZTrace + ViTE


EZTrace 1.1 and ViTE 1.2 are installed on amp and viz.

EZTrace is a tool to analyze event traces, it has several modules:

stdio   Module for stdio functions (read, write, select, poll, etc.)
starpu  module for StarPU framework
pthread Module for PThread synchronization functions (mutex, semaphore, spinlock, etc.)
papi    Module for PAPI Performance counters
openmpi Module for MPI functions
memory  Module for memory functions (malloc, free, etc.)

ViTE is the visualization tool to visualize the generated traces, it can visualize also .otf2 traces obtained from other MPI tracing tools (e.g. converted from TAU)




HPCToolkit


Load modules

module load hpctoolkit

run application with binary instrumentation

srun -n 2 -p green-ib hpcrun <your_application>
hpcstruct `which <your_application>`
hpcprof hpctoolkit-<your_application>-measurements-<PID>

run GUI tool for interpretation

hpcviewer hpctoolkit-<your_application>-database-<PID>

starts hpcviewer and opens the database.




Paraver trace visualizer


Load the module

module load green

module load Paraver

start paraver

wxparaver

then load the .prv trace file




Extrae





Score-P


Scalable Performance Measurement Infrastructure for Parallel Codes

module load green-spack
module load scorep

The module with hash “mlw5” contains the PDT instrumenter. The module with hash “o4v3” contains the PDT instrumenter and libunwind.

https://scorepci.pages.jsc.fz-juelich.de/scorep-pipelines/docs/scorep-4.1/html/quickstart.html

compilation: prefix the compiler command with “scorep”, e.g. scorep gcc ... or scorep mpicc ..., this can also be used in Makefiles:

MPICC = $(PREP) mpicc

(and analogously for linkers and other compilers). One can then use the same makefile to either build an instrumented version with the

make PREP="scorep"

a simple make will generate an uninstrumented binary.

The environment variables SCOREP_ENABLE_TRACING and SCOREP_ENABLE_PROFILING control whether event trace data or profiles are stored in this directory. By setting either variable to true, the corresponding data will be written to the directory. The default values are true for SCOREP_ENABLE_PROFILING and false for SCOREP_ENABLE_TRACING.




Scalasca


Scalasca is a software tool that supports the performance optimization of parallel programs by measuring and analyzing their runtime behavior. The analysis identifies potential performance bottlenecks – in particular those concerning communication and synchronization – and offers guidance in exploring their causes.

module load green-spack
module load scalasca



Open|SpeedShop


module load green-spack
module load openspeedshop
module load openspeedshop-utils



DiscoPoP


to be installed

analyses source-code to find areas that can be parallelized

works only with LLVM 11.1 (included in the module)

module load green
module load discopop



PGI / Nvidia HPC SDK


On the GPU servers, the Nvidia HPC SDK is installed, which contains the PGI compilers and profilers.




IgProf


The Ignominous Profiler. IgProf is a simple nice tool for measuring and analysing application memory and performance characteristics. IgProf requires no changes to the application or the build process.

Quick start: https://igprof.org/running.html