Vtune/fr: Difference between revisions
No edit summary |
(Updating to match new version of source page) |
||
Line 9: | Line 9: | ||
= Module logiciel= | = Module logiciel= | ||
<div class="mw-translate-fuzzy"> | |||
Pour charger le module sur une de nos grappes, lancez | Pour charger le module sur une de nos grappes, lancez | ||
{{Command|module load vtune}} | {{Command|module load vtune}} | ||
</div> | |||
= Changement de noms = | = Changement de noms = | ||
<div class="mw-translate-fuzzy"> | |||
Il sera question ici de Intel® VTune™ Amplifier, dont le nom a été changé pour Intel® VTune™ Profiler dans la documentation des plus récentes versions. Aussi, les commandes <tt>amplxe-cl</tt> et <tt>amplxe-gui</tt> ont été renommées <tt>vtune</tt> et <tt>vtune-gui</tt> respectivement pour la ligne de commande et les outils graphiques. Les versions des modules VTune offertes pour nos grappes sont antérieures au changement de ces noms. Le contenu de cette page sera mis à jour quand le module sera mis à jour dans l'environnement par défaut StdEnv/2020. Pour plus d'information, voyez [https://software.intel.com/content/www/us/en/develop/documentation/vtune-help/top/launch.html cette page du guide de l'utilisateur]. | Il sera question ici de Intel® VTune™ Amplifier, dont le nom a été changé pour Intel® VTune™ Profiler dans la documentation des plus récentes versions. Aussi, les commandes <tt>amplxe-cl</tt> et <tt>amplxe-gui</tt> ont été renommées <tt>vtune</tt> et <tt>vtune-gui</tt> respectivement pour la ligne de commande et les outils graphiques. Les versions des modules VTune offertes pour nos grappes sont antérieures au changement de ces noms. Le contenu de cette page sera mis à jour quand le module sera mis à jour dans l'environnement par défaut StdEnv/2020. Pour plus d'information, voyez [https://software.intel.com/content/www/us/en/develop/documentation/vtune-help/top/launch.html cette page du guide de l'utilisateur]. | ||
</div> | |||
= Types d'analyses = | = Types d'analyses = | ||
<div class="mw-translate-fuzzy"> | |||
Pour collecter de l'information pour analyse, lancez | Pour collecter de l'information pour analyse, lancez | ||
{{Command|amplxe-cl -collect <analysis-type> <target_exe> <exe_arguments>}} | {{Command|amplxe-cl -collect <analysis-type> <target_exe> <exe_arguments>}} | ||
où <analysis-type> est le nom d'un type d'analyse disponible (par ex. ''hotspots''), et <target_exe> est le chemin vers l'exécutable que vous voulez analyser. Nous vous recommandons de compiler votre exécutable avec l'option <tt>-g</tt> et d'utiliser le niveau d'optimisation normal afin d'obtenir des résultats exacts. Il est possible de faire lister sur la ligne de commande des options d'arguments spécifiques à une version ainsi que plusieurs exemples d'utilisation avec <code>amplxe-cl -help</code>, après avoir chargé le module VTune. | où <analysis-type> est le nom d'un type d'analyse disponible (par ex. ''hotspots''), et <target_exe> est le chemin vers l'exécutable que vous voulez analyser. Nous vous recommandons de compiler votre exécutable avec l'option <tt>-g</tt> et d'utiliser le niveau d'optimisation normal afin d'obtenir des résultats exacts. Il est possible de faire lister sur la ligne de commande des options d'arguments spécifiques à une version ainsi que plusieurs exemples d'utilisation avec <code>amplxe-cl -help</code>, après avoir chargé le module VTune. | ||
Téléchargez [https://software.intel.com/content/www/us/en/develop/articles/download-documentation-intel-parallel-studio-xe-current-previous.html la documentation de Parallel Studio XE (incluant VTune)] et le [https://software.intel.com/content/www/us/en/develop/documentation/vtune-help/top.html guide de l'utilisateur Intel VTune Profiler User Guide]. | Téléchargez [https://software.intel.com/content/www/us/en/develop/articles/download-documentation-intel-parallel-studio-xe-current-previous.html la documentation de Parallel Studio XE (incluant VTune)] et le [https://software.intel.com/content/www/us/en/develop/documentation/vtune-help/top.html guide de l'utilisateur Intel VTune Profiler User Guide]. | ||
</div> | |||
= Créer un rapport = | = Créer un rapport = | ||
<div class="mw-translate-fuzzy"> | |||
Pour créer un rapport, lancez | Pour créer un rapport, lancez | ||
{{Command|amplxe-cl -report <report-type> }} | {{Command|amplxe-cl -report <report-type> }} | ||
où <report-type> est le type de rapport à générer (''hotspots''). Voyez aussi la page [https://software.intel.com/en-us/vtune-amplifier-help-generating-command-line-reports Generate Command Line Reports]. | où <report-type> est le type de rapport à générer (''hotspots''). Voyez aussi la page [https://software.intel.com/en-us/vtune-amplifier-help-generating-command-line-reports Generate Command Line Reports]. | ||
</div> | |||
= Exemple de matrice = | = Exemple de matrice = | ||
Line 33: | Line 41: | ||
Pour analyser et générer le projet Intel ''Matrix Sample Project'' en ligne de commande avec 4 cœurs : | Pour analyser et générer le projet Intel ''Matrix Sample Project'' en ligne de commande avec 4 cœurs : | ||
<div class="mw-translate-fuzzy"> | |||
salloc --time=1:00:00 --cpus-per-task=4 --ntasks=1 --mem=16G --account=def-yours | salloc --time=1:00:00 --cpus-per-task=4 --ntasks=1 --mem=16G --account=def-yours | ||
module load StdEnv/2016.4 *OR* StdEnv/2018.3 | module load StdEnv/2016.4 *OR* StdEnv/2018.3 | ||
Line 41: | Line 50: | ||
make icc | make icc | ||
amplxe-cl -collect hotspots ../matrix | amplxe-cl -collect hotspots ../matrix | ||
amplxe-cl -report summary | amplxe-cl -report summary | ||
</div> | |||
La plus récente version de matrix_multiply (qui construit avec <tt>cmake</tt>) [https://github.com/oneapi-src/oneAPI-samples/tree/master/Tools/VTuneProfiler se trouve ici]. | La plus récente version de matrix_multiply (qui construit avec <tt>cmake</tt>) [https://github.com/oneapi-src/oneAPI-samples/tree/master/Tools/VTuneProfiler se trouve ici]. | ||
Line 51: | Line 61: | ||
== Nœuds des grappes == | == Nœuds des grappes == | ||
<div class="mw-translate-fuzzy"> | |||
# Connectez-vous à un nœud de calcul ou à un nœud de connexion avec [https://docs.computecanada.ca/wiki/VNC/fr#Connexion TigerVNC]; | # Connectez-vous à un nœud de calcul ou à un nœud de connexion avec [https://docs.computecanada.ca/wiki/VNC/fr#Connexion TigerVNC]; | ||
# <code>module load StdEnv/2016.4 *OR* StdEnv/2018.3</code> | # <code>module load StdEnv/2016.4 *OR* StdEnv/2018.3</code> | ||
Line 56: | Line 67: | ||
# <code>module load vtune/2019.3</code> | # <code>module load vtune/2019.3</code> | ||
# <code>amplxe-gui</code><br> | # <code>amplxe-gui</code><br> | ||
</div> | |||
== Nœuds VDI == | == Nœuds VDI == | ||
<div class="mw-translate-fuzzy"> | |||
# Connectez-vous à gra-vid avec [https://docs.computecanada.ca/wiki/VNC/fr#Noeuds_VDI TigerVNC]; | # Connectez-vous à gra-vid avec [https://docs.computecanada.ca/wiki/VNC/fr#Noeuds_VDI TigerVNC]; | ||
# <code>module load CcEnv StdEnv/2016.4 *OR* StdEnv/2018.3</code> | # <code>module load CcEnv StdEnv/2016.4 *OR* StdEnv/2018.3</code> | ||
Line 64: | Line 77: | ||
# <code>module load vtune/2019.3</code> | # <code>module load vtune/2019.3</code> | ||
# <code>amplxe-gui</code><br> | # <code>amplxe-gui</code><br> | ||
</div> | |||
Revision as of 15:15, 14 February 2024
Introduction
VTune est un produit d'Intel pour analyser la performance des systèmes et des applications OpenMP et MPI.
Module logiciel
Changement de noms
Il sera question ici de Intel® VTune™ Amplifier, dont le nom a été changé pour Intel® VTune™ Profiler dans la documentation des plus récentes versions. Aussi, les commandes amplxe-cl et amplxe-gui ont été renommées vtune et vtune-gui respectivement pour la ligne de commande et les outils graphiques. Les versions des modules VTune offertes pour nos grappes sont antérieures au changement de ces noms. Le contenu de cette page sera mis à jour quand le module sera mis à jour dans l'environnement par défaut StdEnv/2020. Pour plus d'information, voyez cette page du guide de l'utilisateur.
Types d'analyses
Pour collecter de l'information pour analyse, lancez
[name@server ~]$ amplxe-cl -collect <analysis-type> <target_exe> <exe_arguments>
où <analysis-type> est le nom d'un type d'analyse disponible (par ex. hotspots), et <target_exe> est le chemin vers l'exécutable que vous voulez analyser. Nous vous recommandons de compiler votre exécutable avec l'option -g et d'utiliser le niveau d'optimisation normal afin d'obtenir des résultats exacts. Il est possible de faire lister sur la ligne de commande des options d'arguments spécifiques à une version ainsi que plusieurs exemples d'utilisation avec amplxe-cl -help
, après avoir chargé le module VTune.
Téléchargez la documentation de Parallel Studio XE (incluant VTune) et le guide de l'utilisateur Intel VTune Profiler User Guide.
Créer un rapport
Pour créer un rapport, lancez
[name@server ~]$ amplxe-cl -report <report-type>
où <report-type> est le type de rapport à générer (hotspots). Voyez aussi la page Generate Command Line Reports.
Exemple de matrice
Pour analyser et générer le projet Intel Matrix Sample Project en ligne de commande avec 4 cœurs :
salloc --time=1:00:00 --cpus-per-task=4 --ntasks=1 --mem=16G --account=def-yours module load StdEnv/2016.4 *OR* StdEnv/2018.3 module load intel/2019.3 (optional) module load vtune/2019.3 cp -a $EBROOTVTUNE/vtune_amplifier/samples/en/C++/matrix . cd matrix/linux make icc amplxe-cl -collect hotspots ../matrix amplxe-cl -report summary
La plus récente version de matrix_multiply (qui construit avec cmake) se trouve ici.
Mode graphique
Intel Matrix Sample Project peut être exécuté en mode graphique, comme décrit ici [1]. Pour utiliser VTune dans VNC voyez les directives ci-dessous. Le mode graphique peut être utile pour générer des configurations en commande de ligne, comme décrit ici [2].
Nœuds des grappes
- Connectez-vous à un nœud de calcul ou à un nœud de connexion avec TigerVNC;
module load StdEnv/2016.4 *OR* StdEnv/2018.3
module load intel/2019.3
(optional)module load vtune/2019.3
amplxe-gui
Nœuds VDI
- Connectez-vous à gra-vid avec TigerVNC;
module load CcEnv StdEnv/2016.4 *OR* StdEnv/2018.3
module load intel/2019.3
(optional)module load vtune/2019.3
amplxe-gui
MPI example
First, load the latest VTune module.
module load StdEnv/2020 module load vtune
Then compile your MPI program as you usually would and run it inside a job or in an interactive session started by a salloc command using:
srun aps your_mpi_program.x
After the program finishes, the profiling data will be stored in a directory called aps_result_YYYYMMDD where YYYYMMDD is the current date.
There is a lot of information you can extract from that data. To get the basic summary report of your program's performance, run:
aps-report -D aps_result_YYYYMMDD
where you would replace YYYYMMDD to match the actual directory that has been created. This command creates an HTML file, which can be copied to your own computer and viewed in a browser. The report will clearly identify performance issues that are affecting your code.