Utilisation du collecteur autonome IntelliTraceUsing the IntelliTrace stand-alone collector

Le collecteur autonome IntelliTrace vous permet de collecter des données de diagnostic IntelliTrace pour vos applications exécutées sur des serveurs de production ou d’autres environnements, sans avoir à installer Visual Studio sur l’ordinateur cible ni à modifier l’environnement du système cible.The IntelliTrace stand-alone collector lets you collect IntelliTrace diagnostic data for your apps on production servers or other environments without installing Visual Studio on the target machine and without changing the target system's environment. Ce collecteur fonctionne avec les applications web, SharePoint, WPF et Windows Forms.The IntelliTrace stand-alone collector works on web, SharePoint, WPF and Windows Forms apps. Quand vous avez terminé la collecte des données, supprimez simplement le collecteur pour le désinstaller.When you're done collecting data, just delete the collector to uninstall it.

Regardez IntelliTrace en action : Collecte et analyse des données IntelliTrace dans l’environnement de production pour le débogage (vidéo Channel 9)Watch IntelliTrace in action: Collecting and analyzing IntelliTrace data in production for debugging (Channel 9 video)

Note

Vous pouvez également collecter les mêmes données IntelliTrace pour les applications web et SharePoint s’exécutant sur des ordinateurs distants à l’aide de Microsoft Monitoring Agent en mode Trace .You can also collect the same IntelliTrace data for web and SharePoint apps running on remote machines by using the Microsoft Monitoring Agent in Trace mode.

Vous pouvez collecter les événements de performances dans les données IntelliTrace en exécutant l’agent en mode Monitor .You can collect performance-related events in the IntelliTrace data by running the agent in Monitor mode. Le modeMonitor a moins d’impact sur les performances que le mode Trace ou le collecteur autonome IntelliTrace.Monitor mode has less of a performance impact than Trace mode or the IntelliTrace stand-alone collector. Microsoft Monitoring Agent modifie l’environnement du système cible quand il est installé.Microsoft Monitoring Agent does alter the target system's environment when it is installed. Consultez à l’aide de l’agent Microsoft Monitoring Agent.See Using the Microsoft Monitoring Agent.

SpécificationsRequirements

Quelles applications fonctionnent avec le collecteur ?What apps work with the collector?

  • Applications web ASP.NET hébergées sur Internet Information Services (IIS) version 7.0, 7.5 ou 8.0ASP.NET Web apps hosted on Internet Information Services (IIS) version 7.0, 7.5, and 8.0

  • Applications SharePoint 2010 et SharePoint 2013SharePoint 2010 and SharePoint 2013 applications

  • Applications Windows Presentation Foundation (WPF) et Windows Forms.Windows Presentation Foundation (WPF) and Windows Forms apps.

Comment faire pour démarrer ?How do I get started?

  1. Installer le collecteurInstall the collector

  2. Définir les autorisations pour le répertoire du collecteurSet up permissions for the collector directory

  3. Installer les applets de commande PowerShell IntelliTrace pour collecter les données pour les applications web ou les applications SharePointInstall IntelliTrace PowerShell cmdlets to collect data for Web apps or SharePoint applications

  4. Définir les autorisations du répertoire de fichiers .iTraceSet up permissions for the .iTrace file directory

  5. Collecter les données d’une application web ou d’une application SharePointCollect data from a Web app or SharePoint application

    - ou --or-

    Collecter les données d’une application managéeCollect data from a managed app

  6. Ouvrez le fichier .iTrace dans Visual Studio EnterpriseOpen the .iTrace file in Visual Studio Enterprise

Installer le collecteurInstall the collector

  1. Sur le serveur de votre application, créez le répertoire du collecteur, par exemple : C:\IntelliTraceCollectorOn your app's server, create the collector directory, for example: C:\IntelliTraceCollector

  2. Obtenir le collecteur à partir du Microsoft Download Center ou à partir du dossier d’installation de Visual Studio 2013 Update 3.Get the collector from the Microsoft Download Center or from the Visual Studio 2013 Update 3 installation folder. Collecteur IntelliTrace pour Visual Studio 2013 Update 4:IntelliTrace Collector for Visual Studio 2013 Update 4::

    • Centre de téléchargement Microsoft:Microsoft Download Center:

      1. À côté de IntelliTraceCollector.exe, choisissez Télécharger.Next to IntelliTraceCollector.exe, choose Download.

      2. Enregistrez IntelliTraceCollector.exe dans le répertoire du collecteur, par exemple C:\IntelliTraceCollectorSave IntelliTraceCollector.exe to the collector directory, for example: C:\IntelliTraceCollector

      3. Exécutez IntelliTraceCollector.exe.Run IntelliTraceCollector.exe. Cette opération extrait le fichier IntelliTraceCollection.cab.This extracts the IntelliTraceCollection.cab file.

        - ou -- or -

    • Dossier d’installation de Visual Studio:Visual Studio installation folder:

      1. Copiez IntelliTraceCollection.cab dans le dossier suivant :Copy IntelliTraceCollection.cab from the following folder:

        ..\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\IntelliTrace\12.0.0..\Microsoft Visual Studio 12.0\Common7\IDE\CommonExtensions\Microsoft\IntelliTrace\12.0.0

      2. Placez IntelliTraceCollection.cab dans le répertoire du collecteur, par exemple C:\IntelliTraceCollectorPut IntelliTraceCollection.cab in the collector directory, for example: C:\IntelliTraceCollector

  3. Développez IntelliTraceCollection.cab :Expand IntelliTraceCollection.cab:

    1. Sur le serveur de votre application, ouvrez une fenêtre d’invite de commandes en tant qu’administrateur.On your app's server, open a command prompt window as an administrator.

    2. Accédez au répertoire du collecteur, par exemple C:\IntelliTraceCollectorBrowse to the collector directory, for example: C:\IntelliTraceCollector

    3. Exécutez la commande expand suivante, avec le point (.) à la fin, pour développer IntelliTraceCollection.cab :Use the expand command, including the period (.) at the end, to expand IntelliTraceCollection.cab:

      expand /f:* IntelliTraceCollection.cab .

      Note

      Le point (.) permet de conserver les sous-dossiers qui contiennent les plans de collecte localisés.The period (.) preserves the subfolders that contain localized collection plans.

Définir les autorisations pour le répertoire du collecteurSet up permissions for the collector directory

  1. Sur le serveur de votre application, ouvrez une fenêtre d’invite de commandes en tant qu’administrateur.On your app's server, open a command prompt window as an administrator.

  2. Utilisez la commande Windows icacls pour accorder à l’administrateur du serveur toutes les autorisations d’accès au répertoire du collecteur.Use the Windows icacls command to give the server administrator full permissions to the collector directory. Par exemple :For example:

    icacls "C:\IntelliTraceCollector" /grant " <Domain\AdministratorID > ":Ficacls "C:\IntelliTraceCollector" /grant " <Domain\AdministratorID> ":F

  3. Pour collecter les données d’une application web ou SharePoint :To collect data for a Web app or SharePoint application:

    1. Accordez à l’utilisateur qui exécutera les applets de commande PowerShell IntelliTrace toutes les autorisations d’accès au répertoire du collecteur.Give the person who will run the IntelliTrace PowerShell cmdlets full permissions to the collector directory.

      Par exemple :For example:

      icacls "C:\IntelliTraceCollector" /grant " <DOMAINE\IDutilisateur > ":Ficacls "C:\IntelliTraceCollector" /grant " <Domain\UserID> ":F

    2. Accordez au pool d’applications hébergeant l’application web ou SharePoint les autorisations de lecture et d’exécution pour le répertoire du collecteur.Give the application pool for the Web app or SharePoint application read and execute permissions to the collector directory.

      Par exemple :For example:

      • Pour une application web du pool d’applications DefaultAppPool :For a Web app in the DefaultAppPool application pool:

        icacls "C:\IntelliTraceCollector" /grant "IIS APPPOOL\DefaultAppPool":RX

      • Pour une application SharePoint du pool d’applications SharePoint – 80 :For a SharePoint application in the SharePoint - 80 application pool:

        icacls "C:\IntelliTraceCollector" /grant "IIS APPPOOL\SharePoint - 80":RX

Installer les applets de commande PowerShell IntelliTrace pour collecter les données pour les applications web ou les applications SharePointInstall IntelliTrace PowerShell cmdlets to collect data for Web apps or SharePoint applications

  1. Sur le serveur de votre application, assurez-vous que PowerShell est activée.On your app's server, make sure that PowerShell is enabled. Dans la plupart des versions de Windows Server, vous pouvez ajouter cette fonctionnalité dans l’outil d’administration Gestionnaire de serveur .On most versions of Windows Server, you can add this feature in the Server Manager administrative tool.

    Ajout de PowerShell à l’aide du Gestionnaire de serveurAdding PowerShell by using Server Manager

  2. Installez les applets de commande PowerShell IntelliTrace.Install the IntelliTrace PowerShell cmdlets.

    1. Ouvrez une invite de commandes PowerShell en tant qu’administrateur.Open a PowerShell command window as an administrator.

      1. Choisissez Démarrer, Tous les programmes, Accessoires, Windows PowerShell.Choose Start, All Programs, Accessories, Windows PowerShell.

      2. Choisissez l’une des étapes suivantes :Choose one of the following steps:

        • Sur les systèmes d’exploitation 64 bits, ouvrez le menu contextuel de Windows PowerShell.On 64-bit operating systems, open the shortcut menu for Windows PowerShell. Sélectionnez Exécuter en tant qu’administrateur.Choose Run as administrator.

        • Sur les systèmes d’exploitation 32 bits, ouvrez le menu contextuel de Windows PowerShell (x86).On 32-bit operating systems, open the shortcut menu for Windows PowerShell (x86). Sélectionnez Exécuter en tant qu’administrateur.Choose Run as administrator.

    2. Dans la fenêtre Commande PowerShell, utilisez la commande Import-Module pour importer Microsoft.VisualStudio.IntelliTrace.PowerShell.dll.In the PowerShell command window, use the Import-Module command to import Microsoft.VisualStudio.IntelliTrace.PowerShell.dll.

      Par exemple :For example:

      Import-Module "C:\IntelliTraceCollector\Microsoft.VisualStudio.IntelliTrace.PowerShell.dll"

Définir les autorisations du répertoire de fichiers .iTraceSet up permissions for the .iTrace file directory

  1. Sur le serveur de votre application, créez le répertoire de fichiers .iTrace, par exemple : C:\IntelliTraceLogFilesOn your app's server, create the .iTrace file directory, for example: C:\IntelliTraceLogFiles

    Note

    • Pour éviter de ralentir votre application, choisissez un emplacement sur un disque local rapide et qui n’est pas très actif.To avoid slowing down your app, choose a location on a local high-speed disk that's not very active.
      • Vous pouvez placer les fichiers .iTrace et ceux du collecteur dans le même emplacement.You can put .iTrace files and the collector files in the same place. Dans le cas d’une application web ou SharePoint, cet emplacement doit se trouver en dehors du répertoire qui héberge cette application.However, if you have a Web app or SharePoint application, make sure this place is outside the directory that hosts the application.

    Important

    • Limitez l’accès au répertoire de fichiers .iTrace uniquement aux identités qui ont besoin d’utiliser le collecteur.Restrict the .iTrace file directory only to those identities that must work with the collector. Un fichier .iTrace peut contenir des informations sensibles, telles que les données provenant d’utilisateurs, de bases de données ou d’autres emplacements sources, ainsi que des chaînes de connexion. En effet, IntelliTrace est susceptible d’enregistrer toutes les données passées dans les paramètres de méthode ou en tant que valeurs de retour.An .iTrace file might contain sensitive information, such as data from users, databases, other source locations, and connection strings because IntelliTrace can record any data that passes into method parameters or as return values.
      • Assurez-vous que les utilisateurs qui peuvent ouvrir les fichiers .iTrace ont l’autorité pour afficher des données sensibles.Make sure those who can open .iTrace files have the authority to view sensitive data. Partagez les fichiers .iTrace avec précaution.Use caution when sharing .iTrace files. Si d’autres utilisateurs doivent accéder aux fichiers, copiez ces fichiers dans un emplacement partagé sécurisé.If other people must have access, copy the files to a secure shared location.
  2. Pour une application web ou SharePoint, accordez au pool d’applications correspondant toutes les autorisations d’accès au répertoire de fichiers .iTrace.For a Web app or SharePoint application, give its application pool full permissions to the .iTrace file directory. Pour cela, utilisez au choix la commande Windows icacls ou l’Explorateur Windows (ou l’Explorateur de fichiers).You can use the Windows icacls command or use Windows Explorer (or File Explorer).

    Par exemple :For example:

    • Pour définir des autorisations avec la commande Windows icacls :To set up permissions with the Windows icacls command:

      • Pour une application web du pool d’applications DefaultAppPool :For a Web app in the DefaultAppPool application pool:

        icacls "C:\IntelliTraceLogFiles" /grant "IIS APPPOOL\DefaultAppPool":F

      • Pour une application SharePoint du pool d’applications SharePoint – 80 :For a SharePoint application in the SharePoint - 80 application pool:

        icacls "C:\IntelliTraceLogFiles" /grant "IIS APPPOOL\SharePoint - 80":F

        - ou --or-

    • Pour définir des autorisations avec l’Explorateur Windows (ou l’Explorateur de fichiers) :To set up permissions with Windows Explorer (or File Explorer):

      1. Ouvrez Propriétés pour le répertoire de fichiers .iTrace.Open Properties for the .iTrace file directory.

      2. Sous l’onglet Sécurité , choisissez Modifier, puis Ajouter.On the Security tab, choose Edit, Add.

      3. Vérifiez que l’élément Principaux de sécurité intégrés est affiché dans la zone Sélectionnez le type de cet objet .Make sure Built-in security principals appears in the Select this object type box. Si elle n’est pas présent, choisissez les Types d’objets pour l’ajouter.If it's not there, choose Object Types to add it.

      4. Vérifiez que votre ordinateur local apparaît dans la zone À partir de cet emplacement .Make sure your local computer appears in the From this location box. Si elle n’est pas présent, choisissez emplacements pour le modifier.If it's not there, choose Locations to change it.

      5. Dans la zone Entrez les noms des objets à sélectionner , ajoutez le pool d’applications de l’application web ou SharePoint.In the Enter the object names to select box, add the application pool for the Web app or SharePoint application.

      6. Choisissez Vérifier les noms pour résoudre le nom.Choose Check Names to resolve the name. Cliquez sur OK.Choose OK.

      7. Vérifiez que le pool d’applications dispose des autorisations Contrôle total.Make sure the application pool has Full control.

Collecter les données d’une application web ou d’une application SharePointCollect data from a Web app or SharePoint application

  1. Pour démarrer la collecte des données, ouvrez une fenêtre Commande PowerShell en tant qu’administrateur, puis exécutez la commande suivante :To start collecting data, open a PowerShell command window as an administrator, then run this command:

    Start-IntelliTraceCollection " <ApplicationPool> " <PathToCollectionPlan> <FullPathToITraceFileDirectory>Start-IntelliTraceCollection " <ApplicationPool> " <PathToCollectionPlan> <FullPathToITraceFileDirectory>

    Important

    Après avoir exécuté cette commande, tapez Y pour confirmer que vous souhaitez démarrer la collecte des données.After you run this command, type Y to confirm that you want to start collecting data.

    Par exemple, pour collecter des données d’une application SharePoint exécutée dans le pool d’applications SharePoint - 80 , exécutez :For example, to collect data from a SharePoint application in the SharePoint - 80 application pool:

    Start-IntelliTraceCollection "SharePoint - 80" "C:\IntelliTraceCollector\collection_plan.ASP.NET.default.xml" "C:\IntelliTraceLogFiles"

    ApplicationPoolApplicationPool Nom du pool d’applications dans lequel votre application s’exécute.The name of the application pool where your application runs
    PathToCollectionPlanPathToCollectionPlan Chemin d’accès à un plan de collecte, un fichier .xml qui configure les paramètres du collecteur.The path to a collection plan, an .xml file that configures settings for the collector.

    Vous pouvez spécifier un plan qui est fourni avec le collecteur.You can specify a plan that comes with the collector. Les plans suivants fonctionnent avec les applications web et SharePoint :The following plans work for Web apps and SharePoint applications:

    -plan collection_plan.ASP.NET.default.xml- collection_plan.ASP.NET.default.xml
    Collecte uniquement les événements IntelliTrace et les événements SharePoint, y compris les exceptions, les appels de base de données et les demandes de serveur web.Collects only IntelliTrace events and SharePoint events, including exceptions, database calls, and Web server requests.
    -collection_plan.ASP.NET.trace.xml- collection_plan.ASP.NET.trace.xml
    Collecte les appels de fonction et toutes les données du plan collection_plan.ASP.NET.default.xml.Collects function calls and all the data in collection_plan.ASP.NET.default.xml. Ce plan est approprié pour une analyse détaillée, mais il risque de ralentir votre application davantage que le plan collection_plan.ASP.NET.default.xml.This plan is good for detailed analysis, but it might slow down your app more than collection_plan.ASP.NET.default.xml.

    Pour éviter de ralentir votre application, personnalisez ces plans ou créez votre propre plan.To avoid slowing down your app, customize these plans or create your own plan. Pour des raisons de sécurité, placez tous les plans personnalisés dans le même emplacement sécurisé que les fichiers du collecteur.For security, put any custom plans in the same secure location as the collector files. Consultez Créer et personnaliser des plans de collecte IntelliTrace et Comment puis-je obtenir le maximum de données sans ralentir mon application ?See Creating and Customizing IntelliTrace Collection Plans and How do I get the most data without slowing down my app? Remarque : par défaut, la taille maximale du fichier .iTrace est de 100 Mo.Note: By default, the max size of the .iTrace file is 100 MB. Lorsque le fichier .iTrace atteint cette limite, le collecteur supprime les entrées les plus anciennes pour libérer un espace pour les nouvelles entrées du fichier.When the .iTrace file reaches this limit, the collector deletes the file's earliest entries to make space for newer entries. Pour modifier cette limite, modifiez le plan de collecte MaximumLogFileSize attribut.To change this limit, edit the collection plan's MaximumLogFileSize attribute.

    Où puis-je trouver des versions localisées de ces plans de collecte ?Where can I find localized versions of these collection plans?

    Les plans de collecte localisés sont situés dans les sous-dossiers du collecteur.You can find localized plans in the collector's subfolders.
    FullPathToITraceFileDirectoryFullPathToITraceFileDirectory Chemin d’accès complet au répertoire de fichiers .iTrace.The full path to the .iTrace file directory. Note de sécurité : fournir le chemin d’accès complet, pas un chemin d’accès relatif.Security Note: Provide the full path, not a relative path.

    Le collecteur se connecte au pool d’applications et commence la collecte de données.The collector attaches to the application pool and starts collecting data.

    Puis-je ouvrir le fichier .iTrace en même temps ?Can I open the .iTrace file at this time? Non. Le fichier est verrouillé pendant la collecte des données.No, the file is locked during data collection.

  2. Reproduisez le problème.Reproduce the problem.

  3. Pour prendre un instantané du fichier .iTrace, utilisez la syntaxe suivante :To take a snapshot of the .iTrace file, use this syntax:

    Checkpoint-IntelliTraceCollection " <ApplicationPool> "Checkpoint-IntelliTraceCollection " <ApplicationPool> "

  4. Pour vérifier l’état de la collecte, utilisez la syntaxe suivante :To check collection status, use this syntax:

    Get-IntelliTraceCollectionStatus

  5. Pour arrêter la collecte de données, utilisez la syntaxe suivante :To stop collecting data, use this syntax:

    Stop-IntelliTraceCollection " <ApplicationPool> "Stop-IntelliTraceCollection " <ApplicationPool> "

    Important

    Après avoir exécuté cette commande, tapez Y pour confirmer que vous souhaitez arrêter la collecte de données.After you run this command, type Y to confirm that you want to stop collecting data. Sinon, le collecteur risque de continuer la collecte des données, le fichier iTrace restera verrouillé ou le fichier ne contiendra peut-être aucunes données utiles.Otherwise, the collector might continue collecting data, the iTrace file will remain locked, or the file might not contain any useful data.

  6. Ouvrez le fichier .iTrace dans Visual Studio EnterpriseOpen the .iTrace file in Visual Studio Enterprise

Collecter les données d’une application managéeCollect data from a managed app

  1. Pour démarrer votre application et collecter des données en même temps, utilisez la syntaxe suivante :To start your app and collect data at the same time, use this syntax:

    <FullPathToIntelliTraceCollectorExecutable> \IntelliTraceSC.exe launch /cp: <PathToCollectionPlan> /f: <FullPathToITraceFileDirectoryAndFileName> <PathToAppExecutableFileAndFileName><FullPathToIntelliTraceCollectorExecutable> \IntelliTraceSC.exe launch /cp: <PathToCollectionPlan> /f: <FullPathToITraceFileDirectoryAndFileName> <PathToAppExecutableFileAndFileName>

    Par exemple, pour collecter des données d’une application nommée MyApp, exécutez :For example, to collect data from an app named MyApp:

    C:IntelliTraceCollectorIntelliTraceSC.exe launch /cp:"C:IntelliTraceCollectorcollection_plan.ASP.NET.default.xml" /f:"C:IntelliTraceLogFilesMyApp.itrace" "C:MyAppMyApp.exe"

    FullPathToIntelliTraceCollectorExecutableFullPathToIntelliTraceCollectorExecutable Chemin d’accès complet à l’exécutable du collecteur (IntelliTraceSC.exe).The full path to the collector executable, IntelliTraceSC.exe
    PathToCollectionPlanPathToCollectionPlan Chemin d’accès à un plan de collecte, un fichier .xml qui configure les paramètres du collecteur.The path to a collection plan, an .xml file that configures settings for the collector.

    Vous pouvez spécifier un plan qui est fourni avec le collecteur.You can specify a plan that comes with the collector. Les plans suivants fonctionnent avec les applications managées :The following plans work for managed apps:

    -plan collection_plan.ASP.NET.default.xml- collection_plan.ASP.NET.default.xml
    Collecte uniquement les événements IntelliTrace, y compris les exceptions, les appels de base de données et les demandes de serveur web.Collects IntelliTrace events only, including exceptions, database calls, and Web server requests.
    -collection_plan.ASP.NET.trace.xml- collection_plan.ASP.NET.trace.xml
    Collecte les appels de fonction et toutes les données du plan collection_plan.ASP.NET.default.xml.Collects function calls and all the data in collection_plan.ASP.NET.default.xml. Ce plan est approprié pour une analyse détaillée, mais il risque de ralentir votre application davantage que le plan collection_plan.ASP.NET.default.xml.This plan is good for detailed analysis, but it might slow down your app more than collection_plan.ASP.NET.default.xml.

    Pour éviter de ralentir votre application, personnalisez ces plans ou créez votre propre plan.To avoid slowing down your app, customize these plans or create your own plan. Pour des raisons de sécurité, placez tous les plans personnalisés dans le même emplacement sécurisé que les fichiers du collecteur.For security, put any custom plans in the same secure location as the collector files. Consultez Créer et personnaliser des plans de collecte IntelliTrace et Comment puis-je obtenir le maximum de données sans ralentir mon application ?See Creating and Customizing IntelliTrace Collection Plans and How do I get the most data without slowing down my app? Remarque : par défaut, la taille maximale du fichier .iTrace est de 100 Mo.Note: By default, the max size of the .iTrace file is 100 MB. Lorsque le fichier .iTrace atteint cette limite, le collecteur supprime les entrées les plus anciennes pour libérer un espace pour les nouvelles entrées du fichier.When the .iTrace file reaches this limit, the collector deletes the file's earliest entries to make space for newer entries. Pour modifier cette limite, modifiez le plan de collecte MaximumLogFileSize attribut.To change this limit, edit the collection plan's MaximumLogFileSize attribute.

    Où puis-je trouver des versions localisées de ces plans de collecte ?Where can I find localized versions of these collection plans?

    Les plans de collecte localisés sont situés dans les sous-dossiers du collecteur.You can find localized plans in the collector's subfolders.
    FullPathToITraceFileDirectoryAndFileNameFullPathToITraceFileDirectoryAndFileName Chemin d’accès complet au répertoire du fichier .iTrace et nom du fichier .iTrace avec l’extension .itrace .The full path to the .iTrace file directory and the .iTrace file name with the .itrace extension. Note de sécurité : fournir le chemin d’accès complet, pas un chemin d’accès relatif.Security Note: Provide the full path, not a relative path.
    PathToAppExecutableFileAndFileNamePathToAppExecutableFileAndFileName Chemin d’accès et nom de fichier de votre application managée.The path and file name of your managed app
  2. Arrêtez la collecte de données en quittant l’application.Stop data collection by exiting the app.

  3. Ouvrez le fichier .iTrace dans Visual Studio EnterpriseOpen the .iTrace file in Visual Studio Enterprise

Ouvrez le fichier .iTrace dans Visual Studio EnterpriseOpen the .iTrace file in Visual Studio Enterprise

Note

Pour déboguer avec IntelliTrace et exécuter le code pas à pas, vous devez disposer des fichiers sources et des fichiers de symboles correspondants.To debug with IntelliTrace and step through code, you must have the matching source files and symbol files. Consultez diagnostiquer des problèmes après déploiement.See Diagnose problems after deployment.

  1. Déplacez le fichier .iTrace ou copiez-le sur un ordinateur équipé de Visual Studio Enterprise (mais pas les éditions Professional ou Community).Move the .iTrace file or copy it to a computer with Visual Studio Enterprise (but not Professional or Community editions).

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

    Visual Studio affiche la page Résumé IntelliTrace .Visual Studio shows the IntelliTrace Summary page. Dans la plupart des sections, vous pouvez passer en revue les événements ou autres éléments enregistrés, choisir un élément, puis commencer le débogage avec IntelliTrace à partir de l’endroit et du moment où l’événement s’est produit.In most sections, you can review events or other items, choose an item, and start debugging with IntelliTrace at the point where and when an event happened. Consultez à l’aide des données IntelliTrace enregistrée.See Using saved IntelliTrace data.

    Note

    Pour déboguer avec IntelliTrace et exécuter le code pas à pas, vous devez disposer des fichiers sources et des fichiers de symboles correspondants sur votre ordinateur de développement.To debug with IntelliTrace and step through code, you must have the matching source files and symbol files on your development machine. Consultez diagnostiquer des problèmes après déploiement.See Diagnose problems after deployment.

Comment puis-je obtenir le maximum de données sans ralentir mon application ?How do I get the most data without slowing down my app?

IntelliTrace peut collecter beaucoup de données. L’impact de la collecte sur les performances de votre application dépend donc de la quantité de données collectées et du type de code analysé par IntelliTrace.IntelliTrace can collect lots of data, so the impact on your app's performance depends on the data that IntelliTrace collects and the kind of code it analyzes. Consultez Optimisation de la collecte IntelliTrace sur les serveurs de production.See Optimizing IntelliTrace Collection on Production Servers.

Voici quelques méthodes permettant d’obtenir le maximum de données sans ralentir votre application :Here are some ways to get the most data without slowing down your app:

  • Exécutez le collecteur uniquement si vous soupçonnez qu'un problème, ou si vous pouvez reproduire le problème.Run the collector only when you think there's a problem, or when you can reproduce the problem.

    Démarrez la collecte, reproduisez le problème, puis arrêtez la collecte.Start collection, reproduce the problem, and then stop collection. Ouvrez le fichier .iTrace dans Visual Studio Enterprise et examinez les données.Open the .iTrace file in Visual Studio Enterprise and examine the data. Consultez Ouvrez le fichier .iTrace dans Visual Studio Enterprise.See Open the .iTrace file in Visual Studio Enterprise.

  • Pour les applications web et SharePoint, le collecteur enregistre les données pour chaque application partageant le pool d’applications spécifié.For Web apps and SharePoint applications, the collector records data for every app that shares the specified application pool. La collecte peut donc ralentir n’importe quelle application partageant le même pool d’applications, même si vous choisissez de limiter la collecte aux modules d’une seule application dans un plan de collecte.This might slow down any app that shares the same application pool, even though you can only specify modules for a single app in a collection plan.

    Pour empêcher le collecteur de ralentir d’autres applications, hébergez chaque application dans son propre pool d’applications.To prevent the collector from slowing down other apps, host each app in its own application pool.

  • Passez en revue les événements du plan de collecte pour lesquels IntelliTrace collecte des données.Review the events in the collection plan for which IntelliTrace collects data. Modifiez le plan de collecte en y désactivant les événements qui ne sont pas pertinents ou qui ne vous intéressent pas.Edit the collection plan to disable events that aren't relevant or don't interest you.

    Pour désactiver un événement, définissez l’attribut enabled pour l’élément <DiagnosticEventSpecification> avec la valeur false:To disable an event, set the enabled attribute for the <DiagnosticEventSpecification> element to false:

    <DiagnosticEventSpecification enabled="false">

    Si l’attribut enabled n’existe pas, l’événement est activé.If the enabled attribute doesn't exist, the event is enabled.

    Comment cela améliore-t-il les performances ?How does this improve performance?

    • Réduisez le temps de démarrage en désactivant les événements qui ne sont pas pertinents pour l’application.You can reduce startup time by disabling events that aren't relevant to the app. Par exemple, désactivez les événements Windows Workflow pour les applications qui n’utilisent pas Windows Workflow.For example, disable Windows Workflow events for apps that don't use Windows Workflow.

    • Améliorez les performances de démarrage et d’exécution en désactivant les événements de Registre pour les applications qui accèdent au Registre, mais qui n’affichent pas les problèmes liés aux paramètres du Registre.You can improve both startup and runtime performance by disabling registry events for apps that access the registry but don't show problems with registry settings.

  • Passez en revue les modules du plan de collecte pour lesquels IntelliTrace collecte des données.Review the modules in the collection plan for which IntelliTrace collects data. Modifiez le plan de collecte en y incluant seulement les modules qui vous intéressent :Edit the collection plan to include only the modules that interest you:

    1. Ouvrez le plan de collecte.Open the collection plan. Recherchez l’élément <ModuleList> .Find the <ModuleList> element.

    2. Dans <ModuleList>, définissez l’attribut isExclusionList avec la valeur false.In <ModuleList>, set the isExclusionList attribute to false.

    3. Utilisez l'élément <Name> pour spécifier chaque module avec un des éléments suivants : nom de fichier, valeur de chaîne pour inclure un module dont le nom contient cette chaîne, ou clé publique.Use the <Name> element to specify each module with one of the following: file name, string value to include any module whose name contains that string, or public key.

      Par exemple, pour collecter uniquement des données du module web principal pour l’application web Fabrikam Fiber, créez une liste comme celle-ci :For example, to collect data from just the main Web module of the Fabrikam Fiber Web app, create a list like this one:

    <ModuleList isExclusionList="false">  
       <Name>FabrikamFiber.Web.dll</Name>  
    </ModuleList>  
    

    Pour collecter des données d'un module dont le nom inclut « Fabrikam », créez une liste comme celle-ci :To collect data from any module whose name includes "Fabrikam", create a list like this one:

    <ModuleList isExclusionList="false">  
       <Name>Fabrikam</Name>  
    </ModuleList>  
    

    Pour collecter des données de modules en spécifiant leurs jetons de clé publique, créez une liste comme celle-ci :To collect data from modules by specifying their public key tokens, create a list like this one:

    <ModuleList isExclusionList="false">  
       <Name>PublicKeyToken:B77A5C561934E089</Name>  
       <Name>PublicKeyToken:B03F5F7F11D50A3A</Name>  
       <Name>PublicKeyToken:31BF3856AD364E35</Name>  
       <Name>PublicKeyToken:89845DCD8080CC91</Name>  
       <Name>PublicKeyToken:71E9BCE111E9429C</Name>  
    </ModuleList>  
    

    Comment cela améliore-t-il les performances ?How does this improve performance?

    Cela réduit la quantité d’informations sur les appels de méthode et autres données d’instrumentation qu’IntelliTrace collecte quand l’application démarre et s’exécute.This reduces the amount of method call information and other instrumentation data that IntelliTrace collects when the app starts and runs. Avec ces données, vous pouvez :This data lets you:

    • parcourir le code après la collecte des données ;Step through code after collecting the data.

    • examiner les valeurs passées aux appels de fonction et les valeurs de retour correspondantes.Examine values passed to and returned from function calls.

      Pourquoi ne pas exclure des modules à la place ?Why not exclude modules instead?

      Par défaut, les plans de collecte excluent les modules en définissant l’attribut isExclusionList avec la valeur true.By default, collection plans exclude modules by setting the isExclusionList attribute to true. Toutefois, malgré l’exclusion des modules, il est possible que des données soient collectées dans des modules qui ne répondent pas aux critères de la liste d’exclusion ou qui ne vous intéressent pas (par exemple, les modules tiers ou open source).However, excluding modules might still result in collecting data from modules that don't meet the list's criteria and might not interest you, such as third-party or open-source modules.

  • Y a-t-il des données qu’IntelliTrace ne collecte pas ?Is there any data that IntelliTrace doesn't collect?

    Oui. Pour réduire l’impact sur les performances, IntelliTrace limite la collecte des données aux valeurs de types de données primitives qui sont passées à et retournées par les méthodes ainsi qu’aux valeurs de types de données primitives dans les champs sur les objets de niveau supérieur qui sont passés à et retournés par les méthodes.Yes, to reduce performance impact, IntelliTrace restricts data collection to values of primitive data types passed to and returned from methods and to values of primitive data types in fields on top-level objects passed to and returned from methods.

    Par exemple, supposons que vous avez une signature de méthode AlterEmployee qui accepte un id entier et un objet Employee``oldemployee :For example, suppose you have an AlterEmployee method signature that accepts an integer id and an Employee object oldemployee:

    public Employee AlterEmployee(int id, Employee oldemployee)

    Le type Employee a les attributs suivants : Id, Nameet HomeAddress.The Employee type has the following attributes: Id, Name, and HomeAddress. Une relation d’association existe entre Employee et le type Address .An association relationship exists between Employee and the Address type.

    Relation entre les employés et adresseRelationship between Employee and Address

    Le collecteur enregistre les valeurs pour id, Employee.Id, Employee.Name et l’objet Employee retourné par la méthode AlterEmployee .The collector records values for id, Employee.Id, Employee.Name and the Employee object returned from the AlterEmployee method. Toutefois, le collecteur n’enregistre pas d’informations sur l’objet Address (il indique seulement si cet objet a ou non une valeur null).However, the collector doesn't record information about the Address object other than whether it was null or not. Le collecteur n’enregistre pas non plus de données sur les variables locales de la méthode AlterEmployee , sauf si d’autres méthodes utilisent ces variables locales en tant que paramètres (elles sont alors enregistrées en tant que paramètres de méthode).The collector also doesn't record data about local variables in the AlterEmployee method unless other methods use those local variables as parameters at which point they are recorded as method parameters.

À quel autre endroit puis-je trouver des données IntelliTrace ?Where else can I get IntelliTrace data?

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

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

IntelliTraceIntelliTrace

BlogsBlogs

Utilisation du collecteur autonome IntelliTrace à distanceUsing the IntelliTrace Standalone Collector Remotely

Créer et personnaliser des plans de collecte IntelliTraceCreating and Customizing IntelliTrace Collection Plans

Optimisation de la collecte IntelliTrace sur les serveurs de productionOptimizing IntelliTrace Collection on Production Servers

Blog Visual Studio ALM + TFSVisual Studio ALM + TFS Blog

ForumsForums

Débogueur Visual StudioVisual Studio Debugger

VidéosVideos

Vidéo Channel 9 : Collecte et analyse des données dans l’environnement de productionChannel 9 video: Collecting and analyzing IntelliTrace data