Utilisation des données IntelliTrace enregistréesUsing saved IntelliTrace data

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).Go to specific points in your application's execution when you start debugging from an IntelliTrace log (.iTrace) file. 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.This file can contain performance events, exceptions, threads, test steps, modules, and other system info that IntelliTrace records while your app runs.

Vérifiez que vous disposez des éléments suivants :Make sure that you have:

Que voulez-vous faire ?What do you want to do?

Ouvrir un fichier journal IntelliTraceOpen an IntelliTrace log

Sur un ordinateur avec Visual Studio Enterprise, ouvrez le fichier .iTrace.On a computer with Visual Studio Enterprise, open the .iTrace file.

  • Double-cliquez sur le fichier .iTrace en dehors de Visual Studio ou ouvrez le fichier à partir de Visual Studio.Double-click the .iTrace file outside Visual Studio, or open the file from inside Visual Studio.

    - ou -- or -

  • Si le fichier .iTrace est attaché à un élément de travail Team Foundation Server, suivez ces étapes dans l’élément de travail :If the .iTrace file is attached to a Team Foundation Server work item, follow these steps in the work item:

    • Sous Tous les liens, recherchez le fichier .iTrace.Under All Links, find the .iTrace file. Ouvrez-le.Open it.

      - ou -- or -

    • Sous Étapes de reproduction, cliquez sur le lien IntelliTrace .Under Repro Steps, choose the IntelliTrace link.

Conseil

Si vous avez fermé le fichier IntelliTrace pendant le débogage, vous pouvez le rouvrir facilement.If you closed the IntelliTrace file during debugging, you can reopen it easily. Accédez au menu Déboguer , choisissez IntelliTrace, Afficher le résumé du journal.Go to the Debug menu, choose IntelliTrace, Show Log Summary. Vous pouvez également choisir Afficher le résumé du journal dans la fenêtre IntelliTrace .You can also choose Show Log Summary in the IntelliTrace window. Cette commande est disponible uniquement lorsque vous procédez à un débogage à l’aide d’IntelliTrace.This is available only while debugging with IntelliTrace.

Comprendre le fichier journal IntelliTraceUnderstand the IntelliTrace log

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.Some of the following sections in the .iTrace file appear only if you collected data from a particular source, for example, from Test Manager or from SharePoint applications.

SectionSection ContientContains Source de la collectionCollection Source
Violations de performancesPerformance Violations Événements de performance avec les appels de fonction qui dépassent le seuil configuréPerformance events with function calls that exceed the configured threshold Microsoft Monitoring Agent, soit collecteur autonome ou avec System Center 2012 R2 Operations Manager pour les applications web ASP.NET hébergées sur IISMicrosoft Monitoring Agent, either standalone collector or with System Center 2012 R2 Operations Manager for ASP.NET web apps hosted on IIS
Données d’exceptionException Data Exceptions, notamment la pile des appels pour chaque exceptionExceptions, including the full call stack for each exception Toutes les sourcesAll sources
AnalyseAnalysis Pour les applications SharePoint 2010 et SharePoint 2013 uniquement.For SharePoint 2010 and SharePoint 2013 applications only. 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.Diagnose IntelliTrace and SharePoint events, such as debugger events, ULS events, unhandled exceptions, and other data that the Microsoft Monitoring Agent recorded. Microsoft Monitoring Agent, soit collecteur autonome ou avec System Center 2012 R2 Operations ManagerMicrosoft Monitoring Agent, either standalone collector or with System Center 2012 R2 Operations Manager
Informations systèmeSystem Info Paramètres et spécifications du système hôteSettings and specifications of the host system Toutes les sourcesAll sources
Liste de threadsThreads List Threads exécutés pendant la collectionThreads that ran during collection Toutes les sourcesAll sources
Données de testTest Data Étapes de test et leurs résultats à partir d’une session de testTest steps and their results from a test session Gestionnaire de testsTest Manager
ModulesModules Modules qui ciblent le processus chargé par ordre de chargement.Modules that the target process loaded in the order that they loaded. Toutes les sourcesAll sources
Requête WebWeb Request Données de la demande Web pour la production IIS applications web et SharePoint 2010 et SharePoint 2013Web request data for production IIS web applications and SharePoint 2010 and SharePoint 2013 Microsoft Monitoring Agent et le collecteur autonomeMicrosoft Monitoring Agent and the standalone collector

Voici quelques conseils pour vous aider à retrouver les informations dans chaque section :Here's some tips to help you find information in each section:

  • Pour trier les données, choisissez un en-tête de colonne.Choose a column header to sort data.

  • Pour filtrer les données, utilisez la zone de recherche.Use the search box to filter data. La recherche de texte brut est effectuée dans toutes les colonnes, sauf celles de date.Plain text search works across all columns except the time columns. Vous pouvez également filtrer les recherches sur une colonne spécifique avec un filtre par colonne.You can also filter searches to a specific column with one filter per column. Saisissez le nom de la colonne sans aucun espace, ni deux-points (:), et la valeur de recherche.Type the column name with no spaces, a colon (:), and the search value. Insérez à la suite un point-virgule (;) pour ajouter une autre valeur de colonne et de recherche.Follow this with a semicolon (;) to add another column and search value.

    Par exemple, pour rechercher les événements de performance qui ont le mot « lent » dans la colonne Description , tapez :For example, to find performance events that have the word "slow" in the Description column, type:

    Description:slow

Démarrer le débogage à partir d’un fichier journal IntelliTraceStart debugging from an IntelliTrace log

Violations de performancesPerformance Violations

Examinez les événements de performance qui ont été enregistrés pour votre application.Review the performance events that were recorded for your app. Vous pouvez masquer ces événements qui ne se produisent pas souvent.You can hide those events that don't happen often.

Pour démarrer le débogage à partir d’un événement de performanceTo start debugging from a performance event
  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.Under Performance Violations, review the recorded performance events, their total execution times, and other event information. Approfondissez ensuite les méthodes appelées pendant un événement de performance spécifique.Then dig deeper into the methods that were called during a specific performance event.

    Afficher les détails de l’événement performancesView performance event details

    Vous pouvez aussi uniquement double-cliquer sur l’événement.You can also just double-click the event.

  2. Dans la page d’événement, examinez les durées d’exécution de ces appels.On the event page, review the execution times for these calls. Recherchez un appel lent dans l’arborescence d’exécution.Find a slow call in the execution tree.

    Les appels les plus lents s’affichent dans leur propre section lorsque vous avez plusieurs appels, imbriqués ou non.The slowest calls appear in their own section when you have multiple calls, nested or otherwise.

  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.Expand that call to review any nested calls and parameter values that were recorded at that point in time.

    (Clavier : pour afficher ou masquer un appel imbriqué, appuyez respectivement sur la touche Flèche droite ou Flèche gauche .(Keyboard: To show or hide a nested call, press the Right Arrow or Left Arrow key respectively. Pour afficher et masquer les valeurs des paramètres d’un appel imbriqué, appuyez sur la touche Espace .)To show and hide parameter values for a nested call, press the Space key.)

    Démarrez le débogage à partir de l’appel.Start debugging from the call.

    Démarrer le débogage à partir de l’appel de méthodeStart debugging from method call

    Vous pouvez également simplement double-cliquer sur l’appel ou appuyer sur la touche Entrée .You can also just double-click the call or press the Enter key.

    Si la méthode se trouve dans votre code d’application, Visual Studio y accède.If the method is in your application code, Visual Studio goes to that method.

    Accédez au code de l’application à partir de l’événement de performancesGo 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.Now you can review other recorded values, the call stack, step through your code, or use the IntelliTrace window to move backwards or forwards "in time" between other methods that were called during this performance event.

Données d’exceptionException Data

Examinez les exceptions levées et enregistrées pour votre application.Review the exceptions that were thrown and recorded for your app. 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.You can group exceptions that have the same type and call stack so that you see only the most recent exception.

Pour démarrer le débogage à partir d’une exceptionTo start debugging from an 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.Under Exception Data, review the recorded exception events, their types, messages, and when the exceptions happened. Pour approfondir le code, démarrez le débogage à partir de l’événement le plus récent d’un groupe d’exceptions.To dig deeper into the code, start debugging from the most recent event in a group of exceptions.

    Démarrer le débogage à partir de l’événement d’exceptionStart debugging from exception event

    Vous pouvez aussi uniquement double-cliquer sur l’événement.You can also just double-click the event. Si les événements ne sont pas regroupés, choisissez Déboguer cet événement.If the events aren't grouped, choose Debug This Event.

    Si l’exception s’est produite dans votre code d’application, Visual Studio accède à l’emplacement où l’exception s’est produite.If the exception happened in your application code, Visual Studio goes to where the exception happened.

    Accédez au code de l’application à partir d’un événement d’exceptionGo 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.Now you can review other recorded values, the call stack, or use the IntelliTrace window to move backwards or forwards "in time" between other recorded events, related code, and the values recorded at those points in time.

    ColonneColumn AfficheShows the
    TypeType Type .NET de l’exception.NET type of the exception
    Message le plus récent pour les exceptions groupées ou Message pour les exceptions non groupéesNewest Message for grouped exceptions or Message for ungrouped exceptions Message fourni par l’exceptionThe message provided by the exception
    Nombre pour les exceptions groupéesCount for grouped exceptions Nombre de fois où l’exception a été levéeThe number of times the exception was thrown
    ID de thread pour les exceptions non groupéesThread ID for ungrouped exceptions ID du thread qui a levé l’exceptionID of the thread that threw the exception
    Heure de l’événement le plus récent ou Heure de l’événementNewest Event Time or Event Time Horodatage enregistré lors de la levée de l’exceptionTime stamp recorded when the exception was thrown
    Pile des appelsCall Stack Pile des appels pour une exception.Call stack for an exception.

    Pour consulter la pile des appels, choisissez une exception dans la liste.To see the call stack, choose an exception in the list. La pile des appels apparaît sous la liste d’exceptions.The call stack appears below the exception list.

AnalyseAnalysis

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.Diagnose problems with SharePoint 2010 and SharePoint 2013 applications by using a SharePoint correlation ID or review any unhandled exceptions that Microsoft Monitoring Agent found.

  • Utilisez un ID de corrélation SharePoint pour rechercher ses requêtes et événements Web correspondants.Use a SharePoint correlation ID to find its matching web request and events. Choisissez un événement, puis démarrez le débogage à l’emplacement et au moment où l’événement s’est produit.Choose an event and then start debugging at the point where and when the event happened.

  • 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.If Microsoft Monitoring Agent found unhandled exceptions, choose an exception and then start debugging at the point where and when the exception happened.

Commencer à déboguer avec un ID de corrélation SharePointStart debugging with a SharePoint correlation ID
  1. Copiez l’ID de corrélation SharePoint à partir de sa source.Copy the SharePoint correlation ID from its source.

    Par exemple :For example:

    IntelliTrace - erreur SharePoint - ID de corrélationIntelliTrace - 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.Open the .iTrace file, then go to Analysis and enter the SharePoint correlation ID to review the matching web request and recorded events.

    Journal IntelliTrace - ID de corrélation SharePoint d’entrezIntelliTrace log - Enter SharePoint correlation ID

  3. Sous Événements de requête, examinez les événements.Under Request Events, examine the events. En commençant à partir du haut, les événements apparaissent dans l’ordre dans lequel ils se produisent.Starting from the top, events appear in the order that they happened.

    1. Choisissez un événement pour en afficher les détails.Choose an event to see its details.

    2. Sélectionnez Démarrer le débogage pour démarrer le débogage au point où l’événement s’est produit.Choose Start Debugging to start debugging at the point where the event happened.

      Fichier journal IntelliTrace - afficher une requête web + événementsIntelliTrace log file - View web request + events

    Vous pouvez voir ces types d’événements SharePoint avec des événements IntelliTrace :You can see these kinds of SharePoint events along with IntelliTrace events:

  • Événements de profil utilisateurUser profile events

    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.These events happen when SharePoint loads a user profile and when user profile properties are read or changed.

  • Événements ULS (Unified Logging System)Unified Logging System (ULS) events

    Microsoft Monitoring Agent enregistre un sous-ensemble d’événements SharePoint ULS et de ces champs :Microsoft Monitoring Agent records a subset of SharePoint ULS events and these fields:

    Champ IntelliTraceIntelliTrace field Champ ULS SharePointSharePoint ULS field
    IdId ID de l’événementEventID
    NiveauLevel NiveauLevel
    ID de catégorieCategory Id ID de catégorieCategory Id
    CatégorieCategory CatégorieCategory
    ZoneArea ProduitProduct
    SortieOutput MessageMessage
    ID de corrélationCorrelation Id ID de corrélationCorrelation Id
Démarrer le débogage à partir d’une exception non géréeStart debugging from an unhandled exception
  1. Choisissez un ID de corrélation SharePoint pour une exception.Choose a SharePoint correlation ID for an exception. Les exceptions sont regroupées par type et pile des appels.Exceptions are grouped by type and call stack.

  2. (Facultatif) Développez Pile des appels pour consulter la pile d’appels d’un groupe d’exceptions.(Optional) Expand Call Stack to see the call stack for a group of 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.Choose Debug Exception to start debugging at the point where and when the exception happened.

    Journal IntelliTrace - exceptions SharePoint non géréesIntelliTrace log - SharePoint unhandled exceptions

    Pour une procédure pas à pas, consultez procédure pas à pas : débogage d’une Application SharePoint à l’aide de IntelliTrace.For a walkthrough, see Walkthrough: Debugging a SharePoint Application by Using IntelliTrace. Pour les types de données enregistrées par l’agent, consultez des fonctionnalités IntelliTrace.For the kinds of data that the agent records, see IntelliTrace Features.

Liste de threadsThreads List

Examinez les threads enregistrés qui se sont exécutés dans le processus cible.Examine the recorded threads that ran in the target process. Vous pouvez commencer à déboguer à partir du premier événement IntelliTrace valide d’un thread sélectionné.You can start debugging from the first valid IntelliTrace event in a selected thread.

Pour démarrer le débogage à partir d’un thread spécifiqueTo start debugging from a specific thread
  1. Dans Liste de threads, choisissez un thread.Under Threads List, choose a thread.

  2. En bas de Liste de threads, choisissez Démarrer le débogage.At the bottom of Threads List, choose Start Debugging. Vous pouvez également double-cliquer sur un thread.You can also double-click a thread.

    Pour démarrer le débogage à partir du démarrage de l’application, double-cliquez sur Thread principal.To start debugging from where the app begins, double-click Main Thread. Consultez des fonctionnalités IntelliTrace.See IntelliTrace Features.

    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.Thread data that the user creates might be more useful than threads that a server creates and manages for IIS-hosted Web apps.

ColonneColumn AfficheShows the
IDID Numéro d’ID de threadThread ID number
NameName Nom du thread.Thread name. Threads sans nom apparaissent en tant que «<aucun nom > ».Unnamed threads appear as "<No Name>".
Heure de débutStart Time Heure de création du thread.Time the thread was created
Heure de finEnd Time Heure à laquelle le thread s’est terminéTime the thread was completed

Données de testTest Data

Examinez les données IntelliTrace que le Gestionnaire de tests a enregistrées pendant le test de votre application.Examine the IntelliTrace data that Test Manager recorded while testing your app.

Pour démarrer le débogage à partir d’une étape de test spécifiqueTo start debugging from a specific test step
  1. Développez Grille d’étapes de test.Expand Test Steps Grid. Sélectionnez une étape de test.Choose a test step.

  2. Au bas de Grille d’étapes de test, sélectionnez Démarrer le débogage.At the bottom of Test Steps Grid, choose Start Debugging. Vous pouvez également double-cliquer sur une étape de test.You can also double-click a test step.

    Cette action démarre le débogage à partir du premier événement IntelliTrace valide après l’étape de test sélectionnée.This starts debugging from the first valid IntelliTrace event after the selected test step.

    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.When test data exists, IntelliTrace tries to resolve the associated Team Foundation Server build that was used to perform the test run. Si la build est trouvée, les symboles associés pour l’application sont résolus automatiquement.If the build is found, the associated symbols for the app are resolved automatically.

ChampField AfficheShows the
Session de testTest Session Sessions de test enregistrées.Test sessions that were recorded. En général, il n’en existe qu’une.Typically, there is only one. Cette liste est vide si les données de test ont été créées à l’aide d’un test exploratoire manuel.This list is empty if test data was created using a manual exploratory test.
Cas de testTest Case Cas de test à partir de la session de test sélectionnée.Test cases from the selected test session. Cette liste est vide si les données de test ont été créées à l’aide d’un test exploratoire manuel.This list is empty if test data was created using a manual exploratory test.
Grille d’étapes de testTest Steps Grid Étapes de test enregistrées dont le résultat de test est Réussite ou ÉchecTest steps that were recorded with the test result of pass or fail

Informations systèmeSystem Info

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.This section shows you details about the system that hosted the app, for example, hardware, operating system, environmental and process-specific information.

ModulesModules

Cette section montre les modules chargés par le processus cible.This section shows you the modules that the target process loaded. Les modules apparaissent par ordre de chargement.Modules appear in the order that they loaded.

ColonneColumn AfficheShows the
Nom du moduleModule Name Nom de fichier du moduleModule file name
Chemin du moduleModule Path Emplacement de chargement du module sur le disqueDisk location where the module was loaded
ID de moduleModule ID Identificateur unique du module, spécifique à la version et qui contribue aux fichiers de symboles correspondants (PDB).Unique identifier of the module that is version-specific and contributes to the matching symbol (PDB) files. Consultez Finding symbol (.pdb) files and source files.See Finding symbol (.pdb) files and source files.

Où peut-on obtenir plus d’informations ?Where can I get more information?

Utilisation du collecteur autonome IntelliTraceUsing the IntelliTrace stand-alone collector

Fonctionnalités IntelliTraceIntelliTrace Features

Collecter plus de données de diagnostic dans des tests manuelsCollect more diagnostic data in manual tests

IntelliTraceIntelliTrace

ForumsForums

Débogueur Visual StudioVisual Studio Debugger

ConseilsGuidance

Test de livraison continue avec Visual Studio 2012 - chapitre 6 : boîte à outils de testTesting for Continuous Delivery with Visual Studio 2012 - Chapter 6: A Testing Toolbox