Annoter le code avec NVTX
Nommez les plages pour obtenir des chronologies lisibles.
Annoter le code avec NVTX est une leçon CUDA Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage CUDA Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours CUDA Academy comprend 4 leçons au total.
Les chronologies ont besoin d’étiquettes
Une chronologie brute est remplie de barres anonymes. NVTX vous permet d’ajouter vos propres noms afin que l’outil d’analyse ressemble à votre code. 🏷️
Qu’est-ce que NVTX ?
NVTX est l’extension d’outils de NVIDIA : une petite bibliothèque qui marque des régions et des événements que Nsight dessine ensuite sur la chronologie.
Inclure l’en-tête
Commencez par inclure un en-tête. Ensuite, les appels de marquage sont disponibles partout dans votre code côté hôte.
#include <nvtx3/nvToolsExt.h>Marquer une plage
Entourez une section de travail d’une plage nommée. L’opération d’ouverture la commence et celle de fermeture la termine, en dessinant une barre étiquetée.
nvtxRangePush("load data");
// work here
nvtxRangePop();Les ouvertures et fermetures s’imbriquent
Les plages s’imbriquent comme des parenthèses. Une ouverture interne doit être fermée avant la plage externe, afin que les étiquettes s’empilent correctement sur la chronologie.
Marqueurs instantanés
Pour un instant précis, placez plutôt un marqueur qu’une plage. Il fixe un événement unique, comme le début d’une époque.
nvtxMark("epoch start");Colorez vos plages
Vous pouvez attribuer une couleur à chaque plage afin que les étapes se distinguent en un coup d’œil. Le chargement peut être bleu et le calcul vert.
Des chronologies lisibles
Avec NVTX, votre vue Nsight affiche les phases, comme le prétraitement et l’inférence, par leur nom. Vous n’avez plus à décoder des symboles de noyaux incompréhensibles.
Presque gratuit lorsqu’il est désactivé
Lorsqu’aucun outil d’analyse n’est attaché, les appels NVTX sont presque gratuits. Vous pouvez laisser les annotations dans votre code sans coût réel.
C’est du côté hôte
NVTX annote le code côté hôte, c’est-à-dire la partie CPU qui orchestre le travail. Il délimite les régions dans lesquelles vos noyaux et vos copies s’exécutent.
Enveloppes RAII
En C++ moderne, vous enveloppez souvent une plage dans un petit objet RAII. Il la ferme automatiquement lorsque la portée se termine, afin que vous n’oubliiez jamais de le faire.
Vérification rapide
Vous souhaitez faire apparaître des régions nommées et étiquetées sur votre chronologie Nsight.
Récapitulatif
NVTX transforme les barres mystérieuses en plages et marqueurs nommés. Quelques appels d’ouverture et de fermeture rendent instantanément vos chronologies Nsight lisibles. 👏
Questions Fréquemment Posées
La leçon « Annoter le code avec NVTX » est-elle gratuite ?
Oui — le texte complet de « Annoter le code avec NVTX » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours CUDA Academy, passe à CoddyKit PRO. Le cours CUDA Academy comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Annoter le code avec NVTX » ?
Nommez les plages pour obtenir des chronologies lisibles. Tu pratiques CUDA Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer CUDA Academy ?
Aucune expérience préalable n'est requise. CUDA Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Annoter le code avec NVTX » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon CUDA Academy ?
Oui. Chaque leçon CUDA Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Vue chronologique dans Nsight Systems
- Mesures des noyaux dans Nsight Compute
- Limité par le calcul ou par la mémoire
- Annoter le code avec NVTX