Ajouter des données d’interaction de couche à partir de la ligne de commandeAdd tier interaction data from the command line

Le profilage d’interaction de couche fournit des informations supplémentaires sur les temps d’exécution des appels ADO.NETADO.NET synchrones, contenus dans les fonctions d’applications multicouches qui communiquent avec une ou plusieurs bases de données.Tier interaction profiling provides additional information about the execution times of synchronous ADO.NETADO.NET calls in functions of multi-tiered applications that communicate with one or more databases.

Windows 8 et Windows Server 2012Windows 8 and Windows Server 2012

Pour collecter des données d’interaction de couche à partir d’applications de bureau Windows 8 ou d’applications Windows Server 2012, vous devez utiliser la méthode d’instrumentation.To collect tier interaction data on Windows 8 desktop apps and Windows Server 2012 apps you must use the instrumentation method. La collecte de données d’interaction de couche sur les applications UWP n’est pas prise en charge.Collecting tier interaction data on UWP apps is not supported.

Éditions Visual StudioVisual Studio editions

Pour collecter des données de profilage d’interaction de couche, vous pouvez utiliser n’importe quelle édition de Visual Studio.Tier interaction profiling can be collected using any edition of Visual Studio. Cependant, ces données ne sont consultables que dans Visual Studio Enterprise.However, tier interaction profiling data can be viewed only in Visual Studio Enterprise.

Collecter des données TIP sur un ordinateur distantCollect TIP data on a remote machine

Pour collecter des données d’interaction entre niveaux sur un ordinateur distant, vous devez copier le fichier vs_profiler_<Plateforme>_<Langage>.exe depuis le dossier %VSInstallDir%\Team Tools\Performance Tools\Setups d’un ordinateur Visual Studio vers l’ordinateur distant, puis lancer l’installation.To collect tier interaction data on a remote machine, you must copy the vs_profiler_<Platform>_<Language>.exe file from the %VSInstallDir%\Team Tools\Performance Tools\Setups folder of a Visual Studio machine to the remote computer and install it. Vous ne pouvez pas utiliser les outils de profilage contenus dans le package de téléchargement Débogage à distance.You cannot use the profiling tools in the Remote Debugging download package.

Rapports TIPTIP reports

Les données d’interaction de couche ne sont consultables que dans Visual Studio Enterprise.Tier interaction data can only be viewed in Visual Studio Enterprise. Les rapports d’interaction de couche basés sur des fichiers générés à l’aide de VSPerfReport ne sont pas disponibles.File based tier interaction reports through VSPerfReport are not available.

Ajouter des données d’interaction de couche avec VSPerfCmdAdd tier interaction data with VSPerfCmd

L’outil en ligne de commande VSPerfASPNETCmd permet d’accéder à l’intégralité des fonctionnalités des outils de profilage.The VSPerfASPNETCmd command line tool lets you access the complete functionality available in the Profiling Tools. Pour ajouter des données d’interaction de couche aux données de profilage collectées à l’aide de VSPerfCmd, utilisez l’utilitaire VSPerfCLREnv afin de définir et de supprimer les variables d’environnement qui activent les données d’interaction de couche.To add tier interaction to profiling data collected by using VSPerfCmd, you must use the VSPerfCLREnv utility to set and remove the environment variables that enables tier interaction data. Les options que vous spécifiez et les procédures nécessaires pour collecter des données dépendent du type d’application que vous profilez.The options that you specify and the procedures required to collect data depend on the type of application that you are profiling.

Profiler des applications autonomesProfile stand-alone applications

Pour ajouter des données d’interaction de couche à une application qui n’est pas exécutée par un autre processus, tel qu’une application de bureau Windows qui émet des appels ADO.NETADO.NET synchrones vers une base de données SQL Server, utilisez l’option VSPerfClrEnv /InteractionOn pour définir les variables d’environnement, et VSPerfClrEnv /InteractionOff pour les supprimer.To add tier interaction data to an application that is not run by another process, such as a Windows desktop application that makes synchronous ADO.NETADO.NET calls to a SQLServer database, use the VSPerfClrEnv /InteractionOn option to set the environment variables, and the VSPerfClrEnv /InteractionOff option to remove them.

Dans l’exemple suivant, une application de bureau Windows est profilée à l’aide de la méthode d’instrumentation, et les données d’interaction de couche sont collectées.In the following example, a Windows desktop application is profiled by using the instrumentation method and tier interaction data is collected.

Exemple de profilage d’une application de bureau WindowsProfile a Windows desktop application example

  1. Ouvrez une fenêtre d’invite de commande en tant qu’administrateur.Open a command prompt window with Administrator privileges. Cliquez sur Démarrer, pointez sur Tous les programmes, puis sur Accessoires.Click Start, point to All Programs, and then point to Accessories. Cliquez avec le bouton droit de la souris sur Invite de commande, puis cliquez sur Exécuter en tant qu’administrateur.Right-click Command Prompt, and then click Run As Administrator.

  2. Initialisez les variables d’environnement TiP et celles du profilage .NET.Initialize .NET profiling and the TIP environment variables. Tapez les commandes suivantes :Type the following commands:

    vsperfclrenv /traceon
    vsperfclrenv /interactionon
    
  3. Démarrez le profileur.Start the profiler. Tapez la commande suivante :Type the following command:

    vsperfcmd /start:trace /output:Desktop_tip.vsp
    
  4. Démarrez l’application avec VSPerfCmd.Start the application with VSPerfCmd. Tapez la commande suivante :Type the following command:

    vsperfcmd /launch:DesktopApp.exe
    
  5. Testez l’application pour collecter des données de profilage, puis fermez-la normalement.Exercise the application to collect profiling data, and then close the application in the regular way.

  6. Supprimez les variables d’environnement TiP.Clear the TIP environment variables. Tapez la commande suivante :Type the following command:

    vsperfclrenv /off
    

Pour plus d’informations, consultez Profiler des applications autonomes.For more information, see Profile stand-alone applications.

Profiler des servicesProfile services

Pour profiler des services, y compris les applications ASP.NETASP.NET, utilisez l’option VSPerfClrEnv /GlobalInteractionOn pour définir les variables d’environnement, et VSPerfClrEnv /GlobalInteractionOff pour les supprimer.To profile services, including ASP.NETASP.NET applications, use the VSPerfClrEnv /GlobalInteractionOn option to set the environment variables, and the VSPerfClrEnv /GlobalInteractionOff option to remove them.

Lorsque vous profilez des services, y compris les applications web ASP.NETASP.NET, vous êtes souvent amené à redémarrer l’ordinateur pour activer le profilage.When you are profiling services, including ASP.NETASP.NET Web applications, you will often need to restart the computer to enable profiling.

Dans l’exemple suivant, un service Windows est profilé suivant la méthode par instrumentation, et les données d’interaction de couche sont collectées.In the following example, a Windows service is profiled by using the instrumentation method and tier interaction data is collected.

Exemple de profilage d’un service WindowsProfile a Windows service example

  1. Si nécessaire, installez le service.If necessary, install the service.

  2. Ouvrez une fenêtre d’invite de commande en tant qu’administrateur.Open a command prompt window with Administrator privileges. Cliquez sur Démarrer, pointez sur Tous les programmes, puis sur Accessoires.Click Start, point to All Programs, and then point to Accessories. Cliquez avec le bouton droit de la souris sur Invite de commande, puis cliquez sur Exécuter en tant qu’administrateur.Right-click Command Prompt, and then click Run As Administrator.

  3. Initialisez les variables d’environnement du profilage .NET.Initialize the .NET profiling environment variables. Tapez la commande suivante :Type the following command:

    vsperfclrenv /globaltraceon
    
  4. Initialisez les variables d’environnement TiP.Initialize the TIP environment variables. Tapez la commande suivante :Type the following command:

    vsperfclrenv /globalinteractionon
    
  5. Redémarrez l’ordinateur pour inscrire les variables d’environnement.Restart the computer to register the environment variables.

  6. Ouvrez une fenêtre d’invite de commande en tant qu’administrateur.Open a command prompt window with Administrator privileges.

  7. Démarrez le profileur.Start the profiler. Tapez la commande suivante :Type the following command:

    vsperfcmd /start:trace /output:MiddleTier_tip.vsp /user:SYSTEM /crosssession
    
  8. Si nécessaire, démarrez le service.If necessary, start the service.

  9. Attachez le profileur au service.Attach the profiler to the service. Tapez la commande suivante :Type the following command:

    vsperfcmd /attach:MiddleTier.exe /output:MyService_tip.vsp /user:SYSTEM /crosssession
    
  10. Testez le service, puis collectez des données de profilage.Exercise the service and collect profiling data.

  11. Arrêtez le profileur.Stop the profiler. Tapez la commande suivante :Type the following command:

    vsperfcmd /detach

  12. Supprimez les variables d’environnement TiP et celles du profilage .NET.Clear the .NET and TIP profiling environment variables. Tapez la commande suivante :Type the following command:

    vsperfclrenv /globaloff
    
  13. Redémarrez l’ordinateur pour enregistrer la suppression des variables d’environnement.Restart the computer to register the cleared environment variables.

Pour plus d'informations, consultez l'une des rubriques suivantes :For more information, see one of the following topics:

Profiler des applications web ASP.NETProfile ASP.NET web applications

Profiler des servicesProfile services

Ajouter des données d’interaction de couche avec VSPerfASPNETCmdAdd tier interaction data with VSPerfASPNETCmd

L’outil en ligne de commande VSPerfASPNETCmd vous permet de profiler facilement des applications web ASP.NETASP.NET.The VSPerfASPNETCmd command-line tool enables you to easily profile ASP.NETASP.NET Web applications. Par rapport à l’outil en ligne de commande VSPerfCmd, cet outil comporte moins d’options et ne nécessite ni configuration de variables d’environnement, ni redémarrage de l’ordinateur.Compared with the VSPerfCmd command-line tool, options are reduced, no environment variables have to be set, and rebooting the computer is not required. Ces fonctionnalités de VSPerfASPNETCmd facilitent grandement la collecte de données d’interaction de couche.These features of VSPerfASPNETCmd make the collection of tier interaction data exceptionally easy.

Pour ajouter les données d’interaction de couche aux données de profilage collectées à l’aide de VSPerfASPNETCmd, ajoutez l’option /TIP sur la ligne de commande.To add tier interaction to profiling data collected by using VSPerfASPNETCmd, add the /TIP option to the command line. Par exemple, utilisez la ligne de commande suivante pour collecter les données d’interaction de couche d’une application web ASP.NETASP.NET à l’aide de la méthode d’instrumentation :For example, use the following command line to collect tier interaction data for an ASP.NETASP.NET Web application by using the instrumentation method:

vsperfaspnetcmd /tip /trace http://localhost/MyWebApp

Pour plus d’informations sur VSPerfASPNETCmd, consultez Profilage de site web rapide avec VSPerfASPNETCmd.For more information about VSPerfASPNETCmd, see Rapid web site profiling with VSPerfASPNETCmd.