Partager via


Utilisation des données IntelliTrace enregistrées (C#, Visual Basic, C++)

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 avez effectué ces actions :

Que voulez-vous faire ?

Ouvrir un fichier journal IntelliTrace

Sur un ordinateur avec Visual Studio Enterprise, 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 s’affichent uniquement si vous avez collecté les données d’une source particulière, par exemple, à partir d’applications SharePoint.

Section Contains Source de la collection
Violations de performances Événements de performance avec les appels de fonction qui dépassent le seuil configuré Microsoft Monitoring Agent, collecteur autonome 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, collecteur autonome 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 de threads Threads exécutés pendant la collection Toutes les sources
Modules Modules qui ciblent le processus chargé par ordre de chargement. Toutes les sources
Demande web Données de demande web pour les applications web IIS de production, et SharePoint 2010 et SharePoint 2013 Microsoft Monitoring Agent et le collecteur autonome

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:slow

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

Violations de performances

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 les autres informations associées. Approfondissez ensuite les méthodes appelées pendant un événement de performance spécifique.

    View performance event details

    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 quand 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 les touches 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.

    Start debugging from method call

    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.

    Go to application code from performance event

    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
  1. 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.

    Start debugging from exception event

    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.

    Go to application code from an exception event

    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 - SharePoint error - correlation ID

  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.

    IntelliTrace log - Enter SharePoint correlation ID

  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.

      IntelliTrace log file - View web request + events

    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
    Identifiant EventID
    Niveau Niveau
    ID de la catégorie ID de la 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.

    IntelliTrace log - SharePoint unhandled exceptions

    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 Fonctionnalités IntelliTrace.

Liste de 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 Fonctionnalités 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
Identifiant Numéro d’ID de thread
Nom Nom du thread. Les threads sans nom sont indiqués comme « <No Name> ».
Start Time Heure de création du thread.
Heure de fin Heure à laquelle le thread s’est terminé
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 d’é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 du module Nom de fichier du module
Chemin du module Emplacement de chargement du module sur le disque
ID de module Identificateur unique du module, spécifique à la version et qui contribue aux fichiers de symboles correspondants (PDB). Consultez Finding symbol (.pdb) files and source files.

Où puis-je obtenir plus d'informations ?

Utilisation du collecteur autonome IntelliTrace

Fonctionnalités IntelliTrace

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

IntelliTrace

Forums

Débogueur Visual Studio