Déboguer votre application avec les fichiers journaux IntelliTrace (.iTrace)

Article
02/28/2013

Vous pouvez démarrer une session de débogage IntelliTrace directement à partir d'un fichier journal IntelliTrace (.iTrace).Ce fichier contient des exceptions, des requêtes Web, des threads, des étapes de test, des modules, et d'autres informations système qu'IntelliTrace enregistre pendant que votre application s'exécute.

Observez IntelliTrace en action :

Collecte et analyse des données IntelliTrace dans l'environnement de production pour le débogage (vidéo Channel 9)
Développement, test et débogage de production pour SharePoint (vidéo Channel 9)

Configuration requise

Fichier .iTrace de l'une des sources suivantes :
- Session IntelliTrace dans Visual Studio Ultimate.Consultez Enregistrer l'exécution du code avec IntelliTrace pour le débogage dans Visual Studio.
- Session de test dans Microsoft Test Manager.Cela lie un fichier .iTrace à un élément de travail de Team Foundation Server.Consultez Comment : collecter des données IntelliTrace pour aider au débogage des problèmes difficiles.
- Collecteur autonome pour les applications s'exécutant en dehors de Visual Studio.Consultez Collecter des données IntelliTrace à l'extérieur de Visual Studio avec le collecteur autonome.
- Visual Studio 2012.1 : applications contrôlées par System Center 2012 Service Pack 1 (SP1) - Operations Manager avec le Pack de gestion du profilage IntelliTrace.Consultez Comment configurer l'intégration avec IntelliTrace dans System Center 2012.
Visual Studio Ultimate sur un ordinateur de développement ou un autre ordinateur pour ouvrir les fichiers .iTrace

[!REMARQUE]

Pour déboguer à l'aide d'IntelliTrace et parcourir le code, vous devez disposer des fichiers sources et des fichiers de symboles correspondants.Assurez-vous que ses fichiers de symboles sont dans le chemin d'accès des symboles de Visual Studio.Dans le cas contraire, Visual Studio ne peut pas résoudre les emplacements source et le message « Symboles introuvables » s'affiche. Consultez Rechercher des fichiers de symboles (.pdb), sources et binaires.

Que voulez-vous faire ?

Ouvrir un fichier journal IntelliTrace
Lisez 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 .iTrace 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.

Lisez 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, les applications du Gestionnaire de tests ou SharePoint 2010 avec le collecteur autonome.

Section	Contient	Source de la collection (Visual Studio Ultimate, Gestionnaire de tests, collecteur autonome)
Analyse	Pour les applications SharePoint 2010 uniquement.Cette section vous permet d'examiner des événements IntelliTrace et SharePoint, tels que les événements de débogueur, les événements ULS, les exceptions, et les autres données que le collecteur a stockées.	Collecteur autonome de Visual Studio 2012.1
Liste des threads	Threads exécutées pendant la collection	Toutes les sources
Requêtes Web	Requêtes Web envoyées à un pool d'applications IIS.Ces données sont semblables à celles collectées dans les fichiers journaux IIS W3C.	Collecteur autonome : applications Web hébergées par IIS uniquement
Données d'exception	Exceptions levées par l'application lors de la collecte, y compris l'ensemble de la pile des appels pour chaque exception	Toutes les sources
Données de test	Étapes de test et leurs résultats à partir d'une session de test	Gestionnaire de tests
Informations système	Paramètres et spécifications du système hôte	Toutes les sources
Modules	Modules chargés pendant la collecte	Toutes les sources

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

Dans la plupart des sections, vous pouvez examiner les événements ou les autres éléments, sélectionner un élément, puis choisir Démarrer le débogage.Cette action démarre une session de débogage IntelliTrace à l'emplacement où et au moment où un événement s'est produit.

Conseil
Pour trier des données, choisissez les en-têtes de colonnes.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.Dans la section Requêtes Web, filtrez également vos recherches pour une colonne spécifique.

Analyse

Cette section s'affiche pour les applications SharePoint 2010 uniquement si vous avez enregistré des données avec le collecteur dans Visual Studio 2012.1.Consultez Collecter des données IntelliTrace à l'extérieur de Visual Studio avec le collecteur autonome.

Cette section vous permet d'effectuer les tâches suivantes :

Utilisez un ID de corrélation SharePoint pour rechercher ses requêtes et événements Web correspondants.Vous pouvez choisir un événement, puis démarrer le débogage à l'emplacement où et au moment où l'événement s'est produit.
Examinez toutes les exceptions non gérées trouvées par le collecteur.Vous pouvez choisir une exception, puis démarrer le débogage à l'emplacement où et au moment où l'exception s'est produite.

[!REMARQUE]

Si le message « Symboles introuvables » s'affiche, Visual Studio ne peut résoudre les emplacements source.Assurez-vous que ses fichiers de symboles de l'application (.pdb) sont dans le chemin d'accès des symboles de Visual Studio.Consultez Rechercher des fichiers de symboles (.pdb), sources et binaires.

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

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

Par exemple :
Dans le fichier .iTrace, sous Analyse, vous pouvez écrire l'ID de corrélation SharePoint.Cela vous permet de rechercher la demande correspondante et afficher ses événements inscrits.
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.

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 de profil utilisateur sont lues ou modifiées.

Événements ULS (Unified Logging System)

Le collecteur autonome enregistre un sous-ensemble d'événements ULS SharePoint et 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émarrez le débogage à partir d'une exception non gérée

Choisissez un ID de corrélation SharePoint pour une exception.Les exceptions sont regroupées par type et pile des appels.
(Facultatif) Développez Pile des appels pour consulter la pile des appels pour un groupe d'exceptions.
Sélectionnez Déboguer l'exception pour démarrer le débogage à l'emplacement et au moment où un événement s'est produit.

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 le collecteur, consultez Enregistrer l'exécution du code avec IntelliTrace pour le débogage dans Visual Studio.

Liste des threads

Cette section vous montre les threads exécutés dans le processus cible.Vous pouvez commencer à déboguer à partir du premier événement IntelliTrace valide dans un thread sélectionné.

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

Dans Liste de threads, choisissez un thread.
En bas de la 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 Enregistrer l'exécution du code avec IntelliTrace pour le débogage dans Visual Studio.

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 l'
ID	Numéro d'ID de thread
Nom	Nom du thread.Les threads sans nom apparaissent en tant que « <No Name> ».
Heure de début	Heure de création du thread.
Heure de fin	Heure à laquelle le thread a été terminé

Requêtes Web

Cette section montre les requêtes Web enregistrées qui ont été envoyées à un pool d'applications IIS.Vous pouvez choisir une requête Web pour examiner les événements enregistrés pour cette application.Vous pouvez alors démarrer le débogage à partir d'un événement spécifique.

Par défaut, les requêtes Web s'affichent de haut en bas, selon l'ordre dans lequel ils arrivent au serveur.

Pour afficher les événements enregistrés pour une requête Web spécifique

Dans Requêtes Web, sélectionnez une requête Web.

En bas de Requêtes Web, sélectionnez Détails de la requête.Vous pouvez également double-cliquer sur la requête Web.

La page Détails de la requête s'ouvre pour la requête Web sélectionnée et affiche la série d'événements IntelliTrace enregistrée pour cette requête.En commençant à partir du haut, les événements apparaissent dans l'ordre dans lequel ils se produisent.Filtrez les événements en les sélectionnant dans la liste de catégories ou à l'aide de la zone de recherche.Consultez Enregistrer l'exécution du code avec IntelliTrace pour le débogage dans Visual Studio.

Conseil
La page Détails de la requête s'ouvre dans l'onglet d'aperçu.Cet onglet est remplacé par une nouvelle page Détails de la requête lorsque vous choisissez une autre requête Web.Pour que l'onglet d'aperçu reste ouvert, choisissez Promouvoir dans l'onglet.Ainsi, la prochaine requête Web en ouvrira un nouveau.

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

Dans Événements de requête, choisissez un événement.

Au bas de Événements de requête, sélectionnez Démarrer le débogage.Vous pouvez également double-cliquer sur un événement.

Conseil
Si le fichier .iTrace inclut des informations sur les appels de fonction, parcourez le code en partant de l'emplacement de l'événement.Vous pouvez également voir les paramètres et les valeurs de retour. Pour collecter des informations sur les appels : Dans Visual Studio Ultimate, configurez IntelliTrace pour collecter des informations sur les appels.Consultez Enregistrer l'exécution du code avec IntelliTrace pour le débogage dans Visual Studio. Pour le collecteur autonome IntelliTrace, utilisez le plan de collecte collection_plan.ASP.NET.trace.xml ou un plan de collecte personnalisé.Consultez Collecter des données IntelliTrace à l'extérieur de Visual Studio avec le collecteur autonome. Si le message « Symboles introuvables » s'affiche, Visual Studio ne peut résoudre les emplacements source.Assurez-vous que ses fichiers de symboles (.pdb) de l'application Web sont dans le chemin d'accès des symboles de Visual Studio.Consultez Rechercher des fichiers de symboles (.pdb), sources et binaires.

Si le fichier .iTrace inclut des informations sur les appels de fonction, parcourez le code en partant de l'emplacement de l'événement.Vous pouvez également voir les paramètres et les valeurs de retour.

Pour collecter des informations sur les appels :

Dans Visual Studio Ultimate, configurez IntelliTrace pour collecter des informations sur les appels.Consultez Enregistrer l'exécution du code avec IntelliTrace pour le débogage dans Visual Studio.
Pour le collecteur autonome IntelliTrace, utilisez le plan de collecte collection_plan.ASP.NET.trace.xml ou un plan de collecte personnalisé.Consultez Collecter des données IntelliTrace à l'extérieur de Visual Studio avec le collecteur autonome.

Si le message « Symboles introuvables » s'affiche, Visual Studio ne peut résoudre les emplacements source.Assurez-vous que ses fichiers de symboles (.pdb) de l'application Web sont dans le chemin d'accès des symboles de Visual Studio.Consultez Rechercher des fichiers de symboles (.pdb), sources et binaires.

Colonne	Affiche l'
Méthode	Méthode HTTP envoyée avec la requête
URL cible	URL cible envoyée avec la requête
Temps nécessaire (ms)	Temps en millisecondes entre le moment où le serveur reçoit la requête et celui où le résultat quitte le serveur
État	Code d'état HTTP retourné dans le résultat
ID de la session	ID de session utilisé par IIS pour différencier les utilisateurs. La valeur de l'ID de session est seulement un entier croissant utilisé pour différencier les utilisateurs de session. Il n'est pas lié au concept d'ASP.NET de SessionID.Ainsi, les requêtes Web qui ont le même ID de session appartiennent à la même session utilisateur.
IP du client	Adresse IP enregistrée par IIS pour la requête envoyée
Agent utilisateur	Valeur de la chaîne d'agent utilisateur envoyée avec la requête HTTP
Heure de début	Temps de réception de la requête par le serveur
Heure de fin	Temps de réponse du serveur au client

Pour voir les données d'un point de vue de l'utilisateur, filtrez et regroupez les requêtes Web.Par exemple :
- Pour identifier des échecs, filtrez les requêtes par État.
- Pour afficher les tendances ou le comportement de l'utilisateur, regroupez les échecs par URL cible ou ID de session.
Vous pouvez également filtrer les recherches dans une colonne spécifique.Saisissez le nom de la colonne sans aucun espace, ni deux-points, et la valeur de recherche.

Par exemple, pour rechercher les requêtes Web qui utilisent la méthode GET avec un ID de session spécifique, indiquez :

Method:GET;SessionId:2

Vous pouvez utiliser un filtre par colonne.Pour connaître les colonnes auxquelles un filtre peut être appliqué, regardez l'info-bulle de la zone de recherche Requêtes Web.

Données d'exception

Cette section vous permet d'examiner les exceptions enregistrées qui ont été levées par votre application.Par défaut, les exceptions les plus récentes s'affichent en haut, car les exceptions sont triées par ordre décroissant selon l'Heure de l'événement.

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

Dans Données d'exception, sélectionnez une exception.
Au bas de Données d'exception, sélectionnez Démarrer le débogage.Vous pouvez également double-cliquer sur une exception.

Cette action démarre le débogage au moment de la levée de l'exception.

Conseil
Recherchez plusieurs exceptions qui ont les mêmes Type et ID de thread et qui s'affichent de façon séquentielle.Cela est généralement dû à une exception levée, interceptée, puis levée de nouveau. Pour voir si tel est le cas, sélectionnez chacune de ces exceptions et observez la pile des appels.Vérifiez si la pile des appels augmente ou diminue.Si la pile la plus courte est égale au début de la pile des appels la plus longue, et si l'ID de thread est identique, il est possible que la même exception soit levée à nouveau.L'exception avec la plus longue pile des appels peut être la plus proche de la source du problème.

Recherchez plusieurs exceptions qui ont les mêmes Type et ID de thread et qui s'affichent de façon séquentielle.Cela est généralement dû à une exception levée, interceptée, puis levée de nouveau.

Pour voir si tel est le cas, sélectionnez chacune de ces exceptions et observez la pile des appels.Vérifiez si la pile des appels augmente ou diminue.Si la pile la plus courte est égale au début de la pile des appels la plus longue, et si l'ID de thread est identique, il est possible que la même exception soit levée à nouveau.L'exception avec la plus longue pile des appels peut être la plus proche de la source du problème.

Colonne	Affiche l'
Type	Type .NET de l'exception
Message	Message fourni par l'exception
ID de thread	ID du thread qui a jeté l'exception
HResult	Code d'erreur spécifié dans l'exception.Disponible si cette valeur est définie dans l'exception.
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.

Données de test

Cette section vous permet de consulter les données collectées par le Gestionnaire de tests pendant le test de votre application.

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

Développez la grille d'étapes de test.Sélectionnez une étape de test.
Au bas de Grille d'étape 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 le Team Foundation Server Build associé, utilisé pour effectuer l'exécution du test.Si la génération est trouvée, les symboles associés pour l'application sont résolus automatiquement.

Champ	Affiche l'
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 vous montre les modules chargés par le processus cible.Les modules apparaissent par ordre de chargement.

Colonne	Affiche l'
Nom de module	Nom de fichier de module
Chemin de module	Emplacement du chargement du module sur le disque
ID du module	Identificateur unique du module, spécifique à la version et qui contribue aux fichiers de symbole correspondant (PDB).Consultez [OBSOLÈTE] Comment : spécifier un comportement de chargement et des emplacements de symboles.

Partager via