Partager via


Comment : lire et déboguer des enregistrements IntelliTrace

Accédez aux points spécifiques de l'exécution de votre application lorsque vous démarrez le débogage à partir d'un fichier journal IntelliTrace (.iTrace). Ce fichier contient des événements de performance, des exceptions, des threads, des étapes de test, des modules et d'autres informations système qu'IntelliTrace enregistre pendant que votre application s'exécute.

Vérifiez que vous disposez des éléments suivants :

Que voulez-vous faire ?

  • Ouvrir un fichier journal IntelliTrace

  • Comprendre le fichier journal IntelliTrace

  • Démarrer le débogage à partir d'un fichier journal IntelliTrace

Ouvrir un fichier journal IntelliTrace

Sur un ordinateur avec Visual Studio Ultimate, ouvrez le fichier .iTrace.

  • Double-cliquez sur le fichier .iTrace en dehors de Visual Studio ou ouvrez le fichier à partir de Visual Studio.

    ou

  • Si le fichier .iTrace est attaché à un élément de travail Team Foundation Server, suivez ces étapes dans l'élément de travail :

    • Sous Tous les liens, recherchez le fichier .iTrace. Ouvrez-le.

      ou

    • Sous Étapes de reproduction, cliquez sur le lien IntelliTrace.

Conseil

Si vous avez fermé le fichier IntelliTrace pendant le débogage, vous pouvez le rouvrir facilement.Accédez au menu Déboguer, choisissez IntelliTrace, Afficher le résumé du journal.Vous pouvez également choisir Afficher le résumé du journal dans la fenêtre IntelliTrace.Cette commande est disponible uniquement lorsque vous procédez à un débogage à l'aide d'IntelliTrace.

Comprendre le fichier journal IntelliTrace

Certaines des sections suivantes du fichier .iTrace apparaissent uniquement si vous collectez les données à partir d'une source particulière, par exemple, depuis le Gestionnaire de tests ou les applications SharePoint.

Section

Contient

Source de la collection

Violations de performance

Événements de performance avec les appels de fonction qui dépassent le seuil configuré

Microsoft Monitoring Agent, seul ou avec System Center 2012 R2 Operations Manager pour les applications web ASP.NET hébergées sur IIS

Données d'exception

Exceptions, notamment la pile des appels pour chaque exception

Toutes les sources

Analyse

Pour les applications SharePoint 2010 et SharePoint 2013 uniquement. Diagnostiquer les événements IntelliTrace et SharePoint, tels que les événements de débogueur, les événements ULS, les exceptions non gérées et autres données que Microsoft Monitoring Agent a enregistrées.

Microsoft Monitoring Agent, seul ou avec System Center 2012 R2 Operations Manager

Informations système

Paramètres et spécifications du système hôte

Toutes les sources

Liste des threads

Threads exécutés pendant la collection

Toutes les sources

Données de test

Étapes de test et leurs résultats à partir d'une session de test

Gestionnaire de tests

Modules

Modules qui ciblent le processus chargé par ordre de chargement.

Toutes les sources

Voici quelques conseils pour vous aider à retrouver les informations dans chaque section :

  • Pour trier les données, choisissez un en-tête de colonne.

  • Pour filtrer les données, utilisez la zone de recherche. La recherche de texte brut est effectuée dans toutes les colonnes, sauf celles de date. Vous pouvez également filtrer les recherches sur une colonne spécifique avec un filtre par colonne. Saisissez le nom de la colonne sans aucun espace, ni deux-points (:), et la valeur de recherche. Insérez à la suite un point-virgule (;) pour ajouter une autre valeur de colonne et de recherche.

    Par exemple, pour rechercher les événements de performance qui ont le mot « lent » dans la colonne Description, tapez :

    Description:lent

Démarrer le débogage à partir d'un fichier journal IntelliTrace

Violations de performance

Examinez les événements de performance qui ont été enregistrés pour votre application. Vous pouvez masquer ces événements qui ne se produisent pas souvent.

Pour démarrer le débogage à partir d'un événement de performance

  1. Sous Violations de performances, examinez les événements de performance enregistrés, leurs durées totales d'exécution et autres informations associées. Approfondissez ensuite les méthodes appelées pendant un événement de performance spécifique.

    Afficher les détails de l'événement de performance

    Vous pouvez aussi uniquement double-cliquer sur l'événement.

  2. Dans la page d'événement, examinez les durées d'exécution de ces appels. Recherchez un appel lent dans l'arborescence d'exécution.

    Les appels les plus lents s'affichent dans leur propre section lorsque vous avez plusieurs appels, imbriqués ou non.

  3. Développez cet appel pour examiner les appels imbriqués et les valeurs de paramètre qui ont été enregistrés à ce moment précis.

    (Clavier : pour afficher ou masquer un appel imbriqué, appuyez respectivement sur la touche Flèche droite ou Flèche gauche. Pour afficher et masquer les valeurs des paramètres d'un appel imbriqué, appuyez sur la touche Espace .)

    Démarrez le débogage à partir de l'appel.

    Démarrer le débogage à partir d'un appel de méthode

    Vous pouvez également simplement double-cliquer sur l'appel ou appuyer sur la touche Entrée.

    Si la méthode se trouve dans votre code d'application, Visual Studio y accède.

    Accéder au code de l'application à partir d'un événement de performance

    Vous pouvez maintenant examiner d'autres valeurs enregistrées, la pile des appels, parcourir votre code ou utiliser la fenêtre IntelliTrace pour remonter ou avancer « dans le temps » entre d'autres méthodes appelées pendant cet événement de performance.

Données d'exception

Examinez les exceptions levées et enregistrées pour votre application. Vous pouvez regrouper les exceptions qui ont le même type et la même pile des appels afin d'afficher uniquement l'exception la plus récente.

Pour démarrer le débogage à partir d'une exception

  • Sous Données d'exception, examinez les événements d'exception enregistrés, leurs types, leurs messages et à quel moment les exceptions se sont produites. Pour approfondir le code, démarrez le débogage à partir de l'événement le plus récent d'un groupe d'exceptions.

    Commencer le débogage à partir d'un événement d'exception

    Vous pouvez aussi uniquement double-cliquer sur l'événement. Si les événements ne sont pas regroupés, choisissez Déboguer cet événement.

    Si l'exception s'est produite dans votre code d'application, Visual Studio accède à l'emplacement où l'exception s'est produite.

    Accéder au code de l'application à partir d'un événement d'exception

    Vous pouvez maintenant examiner d'autres valeurs enregistrées, la pile des appels, ou utiliser la fenêtre IntelliTrace pour remonter ou avancer « dans le temps » entre les autres événements enregistrés, le code connexe et les valeurs enregistrées à ces moments précis.

    Colonne

    Affiche

    Type

    Type .NET de l'exception

    Message le plus récent pour les exceptions groupées ou Message pour les exceptions non groupées

    Message fourni par l'exception

    Nombre pour les exceptions groupées

    Nombre de fois où l'exception a été levée

    ID de thread pour les exceptions non groupées

    ID du thread qui a levé l'exception

    Heure de l'événement le plus récent ou Heure de l'événement

    Horodatage enregistré lors de la levée de l'exception

    Pile des appels

    Pile des appels pour une exception.

    Pour consulter la pile des appels, choisissez une exception dans la liste. La pile des appels apparaît sous la liste d'exceptions.

Analyse

Diagnostiquez les problèmes avec les applications SharePoint 2010 et SharePoint 2013 en utilisant un ID de corrélation SharePoint ou vérifiez toutes les exceptions non gérées que Microsoft Monitoring Agent a trouvées.

  • Utilisez un ID de corrélation SharePoint pour rechercher ses requêtes et événements Web correspondants. Choisissez un événement, puis démarrez le débogage à l'emplacement et au moment où l'événement s'est produit.

  • Si Microsoft Monitoring Agent a trouvé des exceptions non gérées, choisissez une exception, puis démarrez le débogage à l'emplacement et au moment où l'exception s'est produite.

Commencer à déboguer avec un ID de corrélation SharePoint

  1. Copiez l'ID de corrélation SharePoint à partir de sa source.

    Par exemple :

    IntelliTrace - erreur SharePoint - ID de corrélation

  2. Ouvrez le fichier .iTrace, puis pointez sur Analyse et entrez l'ID de corrélation SharePoint pour examiner la demande correspondante de site web et les événements inscrits.

    Journal IntelliTrace - Entrer un ID de corrélation SharePoint

  3. Sous Événements de requête, examinez les événements. En commençant à partir du haut, les événements apparaissent dans l'ordre dans lequel ils se produisent.

    1. Choisissez un événement pour en afficher les détails.

    2. Sélectionnez Démarrer le débogage pour démarrer le débogage au point où l'événement s'est produit.

    Fichier journal IntelliTrace - Afficher une requête web + événements

Vous pouvez voir ces types d'événements SharePoint avec des événements IntelliTrace :

  • Événements de profil utilisateur

    Ces événements se produisent lorsque SharePoint charge un profil utilisateur et lorsque les propriétés du profil utilisateur sont lues ou modifiées.

  • Événements ULS (Unified Logging System)

    Microsoft Monitoring Agent enregistre un sous-ensemble d'événements SharePoint ULS et de ces champs :

    Champ IntelliTrace

    Champ ULS SharePoint

    Id

    EventID

    Niveau

    Niveau

    ID de catégorie

    ID de catégorie

    Catégorie

    Catégorie

    Zone

    Produit

    Sortie

    Message

    ID de corrélation

    ID de corrélation

Démarrer le débogage à partir d'une exception non gérée

  1. Choisissez un ID de corrélation SharePoint pour une exception. Les exceptions sont regroupées par type et pile des appels.

  2. (Facultatif) Développez Pile des appels pour consulter la pile d'appels d'un groupe d'exceptions.

  3. Sélectionnez Exception de débogage pour démarrer le débogage à l'emplacement et au moment où l'exception s'est produite.

    Journal IntelliTrace - exceptions SharePoint non gérées

Pour obtenir une procédure pas à pas, consultez Procédure pas à pas : débogage d'une application SharePoint avec IntelliTrace. Pour connaître les types de données enregistrées par l'agent, consultez Obtenir la mise en route du débogage avec IntelliTrace.

Liste des threads

Examinez les threads enregistrés qui se sont exécutés dans le processus cible. Vous pouvez commencer à déboguer à partir du premier événement IntelliTrace valide d'un thread sélectionné.

Pour démarrer le débogage à partir d'un thread spécifique

  1. Dans Liste de threads, choisissez un thread.

  2. En bas de Liste de threads, choisissez Démarrer le débogage. Vous pouvez également double-cliquer sur un thread.

    Pour démarrer le débogage à partir du démarrage de l'application, double-cliquez sur Thread principal. Consultez Obtenir la mise en route du débogage avec IntelliTrace.

Les données de thread créées par l'utilisateur peuvent être plus utiles que les threads qu'un serveur crée et gère pour les applications web hébergées par IIS.

Colonne

Affiche

ID

Numéro d'ID de thread

Nom

Nom du thread. Les threads sans nom apparaissent en tant que « <Sans nom> ».

Heure de début

Heure de création du thread.

Heure de fin

Heure à laquelle le thread s'est terminé

Données de test

Examinez les données IntelliTrace que le Gestionnaire de tests a enregistrées pendant le test de votre application.

Pour démarrer le débogage à partir d'une étape de test spécifique

  1. Développez Grille d'étapes de test. Sélectionnez une étape de test.

  2. Au bas de Grille d'étapes de test, sélectionnez Démarrer le débogage. Vous pouvez également double-cliquer sur une étape de test.

    Cette action démarre le débogage à partir du premier événement IntelliTrace valide après l'étape de test sélectionnée.

    Si les données de test existent, IntelliTrace tente de résoudre la build Team Foundation Server associée, utilisée pour effectuer l'exécution du test. Si la build est trouvée, les symboles associés pour l'application sont résolus automatiquement.

Champ

Affiche

Session de test

Sessions de test enregistrées. En général, il n'en existe qu'une. Cette liste est vide si les données de test ont été créées à l'aide d'un test exploratoire manuel.

Cas de test

Cas de test à partir de la session de test sélectionnée. Cette liste est vide si les données de test ont été créées à l'aide d'un test exploratoire manuel.

Grille des étapes de test

Étapes de test enregistrées dont le résultat de test est Réussite ou Échec

Informations système

Cette section vous montre les détails sur le système qui a hébergé l'application : par exemple, le matériel, le système d'exploitation et les informations relatives à l'environnement ou spécifiques au processus.

Modules

Cette section montre les modules chargés par le processus cible. Les modules apparaissent par ordre de chargement.

Colonne

Affiche

Nom de module

Nom de fichier du module

Chemin du module

Emplacement de chargement du module sur le disque

ID du module

Identificateur unique du module, spécifique à la version et qui contribue aux fichiers de symboles correspondants (PDB). Consultez [OBSOLÈTE] Comment : spécifier un comportement de chargement et des emplacements de symboles.

Où peut-on obtenir plus d'informations ?

Collecter des données IntelliTrace pour les applications en production avec le collecteur autonome

Obtenir la mise en route du débogage avec IntelliTrace

Collecter plus de données de diagnostic dans des tests manuels

Débogage du code plus rapide en examinant son historique avec IntelliTrace

Forums

Débogueur Visual Studio

Conseils

Test de la livraison continue avec Visual Studio 2012 – Chapitre 6 : Boîte à outils de test