Comment : collecter des données IntelliTrace pour aider au débogage des problèmes difficiles

Article
08/10/2011

Il est possible de configurer l'adaptateur de données de diagnostic pour IntelliTrace à l'aide de Gestionnaire de tests Microsoft ou Microsoft Visual Studio 2010 pour collecter des informations de trace de diagnostic spécifiques. Avec cet adaptateur, le test peut collecter des événements de diagnostic significatifs pouvant être utilisés par le développeur pour repérer la cause du bogue dans le code. L'adaptateur de données de diagnostic pour IntelliTrace peut être utilisé pour des tests manuels ou automatisés.

Notes

IntelliTrace fonctionne uniquement sur une application écrite avec du code managé. 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. Dans ce cas, vous pouvez configurer un environnement pour collecter des données IntelliTrace à distance sur votre serveur Web. Pour plus d'informations sur les environnements, consultez Configuration d'ordinateurs de test pour exécuter des tests ou collecter des données.

Les données IntelliTrace sont stockées dans un fichier ayant une extension .iTrace. Si vous exécutez votre test et qu'une de ses étapes échoue, vous pouvez créer un bogue. Le fichier IntelliTrace qui contient les informations de diagnostic est automatiquement joint à ce bogue.

Notes

L'adaptateur de données de diagnostic pour IntelliTrace ne crée pas de fichier IntelliTrace en cas de réussite du test. Un fichier est enregistré uniquement si un cas de test échoue ou lorsque vous signalez un bogue.

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

Avertissement

Si vous activez IntelliTrace dans vos paramètres de test, la collecte des données de couverture du code ne fonctionnera pas. Pour plus d'informations, consultez Comment : configurer la couverture du code à l'aide de paramètres de test pour les tests automatisés

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. 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. Pour éviter ce problème, assurez-vous que le processus est arrêté avant le chargement des tests. Ensuite, démarrez le processus après le chargement des tests ou le démarrage du premier test.

La procédure suivante décrit comment configurer les données IntelliTrace que vous souhaitez collecter. Ces étapes valent pour aussi bien pour l'éditeur de configuration de Gestionnaire de tests Microsoft que pour la boîte de dialogue Paramètres de test de Microsoft Visual Studio 2010.

Notes

Le compte d'utilisateur de l'agent de test qui est utilisé pour collecter les données IntelliTrace doit être membre du groupe Administrateurs. Pour plus d'informations, consultez Installation et configuration des agents Visual Studio, des contrôleurs de test et de build.

Configurer les données à collecter avec l'adaptateur de données de diagnostic IntelliTrace

Avant d'effectuer les opérations décrites dans cette procédure, vous devez ouvrir vos paramètres de test à partir de Gestionnaire de tests Microsoft ou de Microsoft Visual Studio 2010, puis sélectionner la page Données et diagnostics.

Pour configurer les données à collecter avec l'adaptateur de données de diagnostic IntelliTrace

Sélectionnez le rôle à utiliser pour collecter les données IntelliTrace.
Sélectionnez IntelliTrace.
Si vous ajoutez IntelliTrace pour un rôle de client Web, vous devez également sélectionner Proxy client ASP.NET pour IntelliTrace et l'impact de test.

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.

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é. 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é :

runas /user:domain\name /profile cmd.exe
Cliquez sur Configurer pour qu'IntelliTrace modifie les paramètres IntelliTrace par défaut.

La boîte de dialogue pour configurer les données collectées s'affiche.

Avertissement

Si vous activez la collecte de données IntelliTrace, la collecte des données de couverture du code ne fonctionnera pas.
Cliquez sur 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.

-ou-

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. Ce niveau de traçage peut avoir un impact sur les performances lorsque vous exécutez vos tests.
Si vous voulez collecter les données de votre application ASP.NET qui s'exécute sur les services IIS (Internet Information Services), sélectionnez Collecter les données à partir d'applications ASP.NET exécutées sur les services Internet (IIS).
Cliquez sur l'onglet Modules. Sélectionnez Collecter les données de tous les modules à l'exception des suivants, puis cliquez sur Ajouter pour ajouter un module à la liste et sur Supprimer pour supprimer un 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.

ou

Sélectionnez Collecter les données des modules suivants uniquement et cliquez sur Ajouter pour ajouter un module à la liste et Supprimer pour supprimer un module. Cette option vous permet de spécifier quels modules doivent être utilisés.

Notes

Si possible, sélectionnez les processus spécifiques que vous souhaitez surveiller. Cela est recommandé pour une performance optimale.
Cliquez sur l'onglet Processus. Sélectionnez Collecter les données de tous les processus à l'exception des suivants et cliquez sur Ajouter pour ajouter un processus à la liste et Supprimer pour supprimer un processus. 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.

ou

Sélectionnez Collecter les données des processus spécifiés uniquement et cliquez sur Ajouter pour ajouter un processus à la liste et Supprimer pour supprimer un processus. Cette option vous permet de spécifier quels processus doivent être utilisés.
(Facultatif) Cliquez sur 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.
(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.

Notes

Pour plus d'informations, consultez Collecte d'informations relatives à IntelliTrace.
(Facultatif) Cliquez sur l'onglet Avancé. Ensuite, cliquez sur la flèche en regard de Espace disque maximal pour l'enregistrement et sélectionnez l'espace maximal que le fichier IntelliTrace doit utiliser.

Notes

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. Pour plus d'informations sur l'augmentation des valeurs du délai d'expiration pour les adaptateurs de données de diagnostic, consultez Comment : éviter les délais d'attente des adaptateurs de données de diagnostic.
Si vous utilisez Gestionnaire de tests Microsoft, cliquez sur Enregistrer. Si vous utilisez Visual Studio, cliquez sur OK. Les paramètres IntelliTrace sont maintenant configurés et enregistrés pour vos paramètres de test.

Notes

Pour réinitialiser la configuration de cet adaptateur de données de diagnostic, cliquez sur Rétablir la configuration par défaut pour Visual Studio ou Rétablir les valeurs par défaut pour Gestionnaire de tests Microsoft.