Comment : collecter des données IntelliTrace pour aider au débogage des problèmes difficilesHow to: Collect IntelliTrace Data to Help Debug Difficult Issues

Vous pouvez configurer l’adaptateur de données de diagnostic pour IntelliTrace pour collecter des informations de trace de diagnostic spécifiques dans Visual Studio.You can configure the diagnostic data adapter for IntelliTrace to collect specific diagnostic trace information in Visual Stdio. Avec cet adaptateur, le test peut collecter des événements de diagnostic significatifs pouvant être utilisés ultérieurement par un développeur pour repérer la cause d'un bogue dans le code.Tests can use this adapter, the test can collect significant diagnostic events for the application that a developer can use later to trace through the code to find the cause of a bug. L'adaptateur de données de diagnostic pour IntelliTrace peut être utilisé pour des tests manuels ou automatisés.The diagnostic data adapter for IntelliTrace can be used for either manual or automated tests.

Note

IntelliTrace fonctionne uniquement sur une application écrite avec du code managé.IntelliTrace works only on an application that is written by using managed code. Si vous testez une application Web qui utilise un navigateur comme client, vous ne devez pas activer IntelliTrace pour ce client dans vos paramètres de test, car aucun code managé n'est disponible pour effectuer le suivi.If you are testing a Web application that uses a browser as a client, you should not enable IntelliTrace for the client in your test settings because no managed code is available to trace. Dans ce cas, vous pouvez configurer un environnement pour collecter des données IntelliTrace à distance sur votre serveur web.In this case, you may want to set up an environment and collect IntelliTrace data remotely on your Web server.

Les données IntelliTrace sont stockées dans un fichier ayant une extension .iTrace.The IntelliTrace data is stored in a file that has an extension of .iTrace. Si vous exécutez votre test et qu'une de ses étapes échoue, vous pouvez créer un bogue.When you run your test and a test step fails, you can create a bug. Le fichier IntelliTrace qui contient les informations de diagnostic est automatiquement joint à ce bogue.The IntelliTrace file that contains the diagnostic information is automatically attached to this bug.

Note

L'adaptateur de données de diagnostic pour IntelliTrace ne crée pas de fichier IntelliTrace en cas de réussite du test.The diagnostic data adapter for IntelliTrace does not create an IntelliTrace file when a test pass is successful. Un fichier est enregistré uniquement si un cas de test échoue ou lorsque vous signalez un bogue.It saves a file only on a failed test case or when you submit a bug.

Les données collectées dans le fichier IntelliTrace accroissent l'efficacité du débogage en réduisant le temps nécessaire à la reproduction et au diagnostic d'une erreur dans le code.The data that is collected in the IntelliTrace file increases debugging productivity by reducing the time that is required to reproduce and diagnose an error in your code. En outre, étant donné que vous pouvez partager le fichier IntelliTrace avec une autre personne qui peut répliquer votre session locale sur son ordinateur, la probabilité d'un bogue non reproductible est réduite.Additionally, because you can share the IntelliTrace file with another individual who can replicate your local session on their computer, it reduces the probability that a bug will be non-reproducible.

Note

Si vous activez IntelliTrace dans vos paramètres de test, la collecte des données de couverture du code ne fonctionnera pas.If you enable IntelliTrace in your test settings, collecting code coverage data will not work.

Avertissement

L'adaptateur de données de diagnostic pour IntelliTrace fonctionne en instrumentant un processus managé, qui doit être exécuté après le chargement des tests de la série.The diagnostic data adapter for IntelliTrace works by instrumenting a managed process, which must be performed after the tests for the test run are loaded. Si le processus que vous souhaitez contrôler a déjà été lancé, aucun fichier IntelliTrace ne sera collecté car le processus est déjà en cours d'exécution.If the process that you want to monitor has already started, no IntelliTrace files will be collected because the process is already running. Pour éviter ce problème, assurez-vous que le processus est arrêté avant le chargement des tests.To circumvent this, make sure that the process is stopped before the tests are loaded. Ensuite, démarrez le processus après le chargement des tests ou le démarrage du premier test.Then start the process after the tests are loaded or the first test is started.

La procédure suivante décrit comment configurer les données IntelliTrace que vous souhaitez collecter.The following procedure describes how to configure the IntelliTrace data that you want to collect. Ces étapes valent aussi bien pour l’éditeur de configuration de Microsoft Test Manager que pour la boîte de dialogue Paramètres de test de Visual Studio.These steps apply to both the configuration editor in Microsoft Test Manager and Test Settings dialog box in Visual Studio.

Note

Le compte d’utilisateur de l’agent de test qui est utilisé pour collecter les données IntelliTrace doit être membre du groupe Administrateurs.The user account for the test agent that is used to collect IntelliTrace data must be a member of the administrators group. Pour plus d’informations, consultez Installer et configurer des agents de test.For more information, see Install and configure test agents.

Configurer les données à collecter avec l'adaptateur de données de diagnostic IntelliTraceConfigure the Data to Collect with the IntelliTrace Diagnostic Data Adapter

Avant d’effectuer les opérations décrites dans cette procédure, vous devez ouvrir vos paramètres de test à partir de Microsoft Test Manager ou de Visual Studio, puis sélectionner la page Données et diagnostics.Before you perform the steps in this procedure, you must open your test settings from either Microsoft Test Manager or Visual Studio and select the Data and Diagnostics page.

Pour configurer les données à collecter avec l'adaptateur de données de diagnostic IntelliTraceTo configure the data to collect with the IntelliTrace Diagnostic Data Adapter

  1. Sélectionnez le rôle à utiliser pour collecter les données IntelliTrace.Select the role to use to collect IntelliTrace data.

  2. Sélectionnez IntelliTrace.Select IntelliTrace.

  3. Si vous ajoutez IntelliTrace pour un rôle de client web ou pour une application web ASP.NET, vous devez également sélectionner Proxy client ASP.NET pour IntelliTrace et l’impact de test.If you are adding IntelliTrace for a Web client role or for an ASP.NET Web application, you must also select ASP.NET Client Proxy for IntelliTrace and Test Impact.

    Ce proxy vous permet de collecter des informations sur les appels http d’un client à un serveur web pour les adaptateurs de données de diagnostic d’impact de test et IntelliTrace.This proxy enables you to collect information about the http calls from a client to a Web server for the IntelliTrace and Test Impact diagnostic data adapters.

    Avertissement

    Si vous décidez d'utiliser un compte personnalisé pour l'identité utilisée pour le pool d'applications sur Internet Information Server (IIS) où vous envisagez de collecter des données Intellitrace, vous devez créer le profil utilisateur local sur l'ordinateur IIS pour le compte personnalisé utilisé.If you decide to use a custom account for the identity that is being used for the application pool on the Internet Information Server (IIS) where you intend to collect Intellitrace data, you must create the local user profile on the IIS machine for the custom account that is being used. Vous pouvez créer le profil local pour le compte personnalisé en vous ouvrant localement une session sur l'ordinateur IIS ou en exécutant la ligne de commande suivante à l'aide des informations d'identification du compte personnalisé :You can create the local profile for the custom account either by logging on to the IIS machine locally one time or by running the following command line by using the custom account credentials:

    runas /user:domain\name /profile cmd.exerunas /user:domain\name /profile cmd.exe

  4. Choisissez Configurer pour qu’IntelliTrace modifie les paramètres IntelliTrace par défaut.Choose Configure for IntelliTrace to modify default IntelliTrace settings.

    La boîte de dialogue pour configurer les données collectées s'affiche.The dialog box to configure the data that will be collected is displayed.

    Avertissement

    Si vous activez la collecte de données IntelliTrace, la collecte des données de couverture du code ne fonctionnera pas.If you enable collecting IntelliTrace data, collecting code coverage data will not work.

  5. Choisissez l’onglet Général. Sélectionnez Événements IntelliTrace uniquement pour enregistrer des événements de diagnostic significatifs qu ont un impact minimal sur les performances lors de vos tests.Choose the General tab. Select IntelliTrace events only to record significant diagnostic events that have minimal impact on performance when you test.

    -ou--or-

    Sélectionnez Événements IntelliTrace et informations d’appels pour enregistrer des événements de diagnostic et le traçage au niveau de la méthode affichant des informations sur les appels.Select IntelliTrace events and call information to record diagnostic events and method level tracing that shows call information. Ce niveau de traçage peut avoir un impact sur les performances lorsque vous exécutez vos tests.This level of tracing might have performance impact when you run your tests.

  6. Pour collecter des données à partir de votre application ASP.NET qui s’exécute sur Internet Information Services, sélectionnez Collecter des données à partir d’une application ASP.NET exécutée sur Internet Information Services.To collect data from your ASP.NET application that is running on Internet Information Services, select Collect data from ASP.NET applications that are running on Internet Information Services. Installez et configurez votre agent de test sur le rôle serveur Web.Set up and configure your test agent on the Web server role. Consultez Installer et configurer des agents de test.See Install and configure test agents.

  7. Choisissez l’onglet Modules. Sélectionnez Collecter les données de tous les modules à l’exception des suivants, et utilisez Ajouter pour ajouter un module à la liste et Supprimer pour supprimer un module.Choose the Modules tab. Select either Collect data from all modules except for the following and use Add to add to the list of modules and Remove to remove a module. Cette option vous permet d'inclure tous les modules en cours d'exécution sur le système, à l'exception des modules que vous spécifiez.This option lets you include all the modules that are running on the system except the modules that you specify.

    - ou --or-

    Sélectionnez Collecter les données des modules suivants uniquement, et utilisez Ajouter pour ajouter un module à la liste et Supprimer pour supprimer un module.Select Collect data from only the following modules and use Add to add to the list of modules and Remove to remove a module. Cette option vous permet de spécifier quels modules doivent être utilisés.This option lets you specify exactly which modules you want.

    Note

    Si possible, sélectionnez les processus spécifiques que vous souhaitez surveiller.If possible, select the specific processes that you want to monitor. Cela est recommandé pour une performance optimale.This is recommended for optimum performance.

  8. Choisissez l’onglet Processus. Sélectionnez Collecter les données de tous les processus à l’exception des suivants, et utilisez Ajouter pour ajouter un processus à la liste et Supprimer pour supprimer un processus.Choose the Processes tab. Select Collect data from all processes except for the following and use Add to add to the list of processes and Remove to remove a process. Cette option vous permet d'inclure tous les processus qui s'exécutent sur le système, à l'exception des processus que vous spécifiez.This option lets you include all the processes that are running on the system except the processes that you specify.

    - ou --or-

    Sélectionnez Collecter les données des processus spécifiés uniquement, et utilisez Ajouter pour ajouter un processus à la liste et Supprimer pour supprimer un processus.Select Collect data from specified processes only and use Add to add to the list of processes and Remove to remove a process. Cette option vous permet de spécifier quels processus doivent être utilisés.This option lets you specify exactly which processes you want.

  9. (Facultatif) Choisissez l’onglet Événements IntelliTrace. Activez ou désactivez chaque catégorie d’événement IntelliTrace à inclure ou exclure lorsque vous collectez des événements de diagnostic.(Optional) Choose the IntelliTrace Events tab. Select or clear each IntelliTrace event category that you want to include or exclude when you collect diagnostic events.

  10. (Facultatif) Développez chaque catégorie d’événement IntelliTrace et activez ou désactivez chaque événement spécifique à inclure ou exclure dans les événements IntelliTrace.(Optional) Expand each IntelliTrace event category and select or clear each specific event that you want to include or exclude in the IntelliTrace events.

  11. (Facultatif) Choisissez l’onglet Avancé. Ensuite, cliquez sur la flèche à côté de Quantité maximale d’espace disque pour chaque enregistrement et sélectionnez l’espace maximal que le fichier IntelliTrace doit utiliser.(Optional) Choose the Advanced tab. Next, choose the arrow next to Maximum amount of disk space for recording and select the maximum size that you want to enable for the IntelliTrace file to use.

    Note

    Si vous augmentez la taille de l'enregistrement, un problème de délai d'expiration peut se produire lorsque vous enregistrez cet enregistrement avec vos résultats de test.If you increase the size of the recording, a time-out issue might occur when you save this recording together with your test results. Pour plus d’informations sur l’augmentation des valeurs du délai d’expiration pour les adaptateurs de données de diagnostic, consultez Guide pratique pour éviter les dépassements des délais d’expiration des adaptateurs de données de diagnostic.For more information about how to increase the time-out values for diagnostic data adapters, see How to: Prevent Time-Outs for Diagnostic Data Adapters.

  12. Si vous utilisez Microsoft Test Manager, choisissez Enregistrer.If you are using Microsoft Test Manager, choose Save. Si vous utilisez Visual Studio, choisissez OK.If you are using Visual Studio, choose OK. Les paramètres IntelliTrace sont maintenant configurés et enregistrés pour vos paramètres de test.The IntelliTrace settings are now configured and saved for your test settings.

    Note

    Pour réinitialiser la configuration de cet adaptateur de données de diagnostic, choisissez Rétablir la configuration par défaut pour Visual Studio ou Rétablir les valeurs par défaut pour Microsoft Test Manager.To reset the configuration for this diagnostic data adapter, choose Reset to default configuration for Visual Studio or Reset to default for Microsoft Test Manager.

Voir aussiSee also