Profilage de site web rapide avec VSPerfASPNETCmdRapid Web Site Profiling 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.In comparison to the VSPerfCmd command line tool, options are reduced, no environment variables have to be set, and rebooting the computer is not required. L’utilisation de VSPerfASPNETCmd est la méthode recommandée pour le profilage avec le profileur autonome.Using VSPerfASPNETCmd is the preferred method for profiling with the standalone profiler. Pour plus d’informations, consultez Guide pratique pour installer le profileur autonome.For more information, see How to: Install the stand-alone profiler.

Note

Les fonctionnalités de sécurité renforcée de Windows 8 et Windows Server 2012 ont imposé des changements importants dans la façon dont le profileur Visual Studio collecte les données sur ces plateformes.Enhanced security features in Windows 8 and Windows Server 2012 required significant changes in the way the Visual Studio profiler collects data on these platforms. Les applications UWP nécessitent aussi de nouvelles techniques de collecte.UWP apps also require new collection techniques. Consultez Outils d’analyse des performances sur les applications Windows 8 et Windows Server 2012.See Performance tools on Windows 8 and Windows Server 2012 applications.

Dans certains scénarios, comme la collecte des données d’accès concurrentiel, ou la suspension et reprise du profilage, VSPerfCmd est la méthode de profilage recommandée.In some scenarios, such as collecting concurrency data or pausing and resuming profiling, using VSPerfCmd is the preferred profiling method.

Note

Les outils en ligne de commande des Outils de profilage se trouvent dans le sous-répertoire \Team Tools\Performance Tools du répertoire d’installation de Visual Studio.Command-line tools of the Profiling Tools are located in the \Team Tools\Performance Tools subdirectory of the Visual Studio installation directory. Sur les ordinateurs 64 bits, utilisez l’outil VSPerfASPNETCmd qui se trouve dans le répertoire 32 bits \Team Tools\Performance Tools.On 64-bit computers, use the VSPerfASPNETCmd tool located in the 32 bit \Team Tools\Performance Tools directory. Pour utiliser les outils en ligne de commande du profileur, vous devez ajouter le chemin des outils à la variable d’environnement PATH dans la fenêtre d’invite de commandes ou bien l’ajouter à la commande elle-même.To use the profiler command-line tools, you must add the tools path to the PATH environment variable of the command prompt window or add it to the command itself. Pour plus d’informations, consultez Spécification du chemin d’accès aux outils en ligne de commande.For more information, see Specifying the Path to Command Line Tools.

Profiler une application ASP.NETProfiling an ASP.NET application

Pour profiler une application web ASP.NETASP.NET, tapez une des commandes décrites dans les sections suivantes.To profile an ASP.NETASP.NET Web application, type one of the commands described in the following sections. Votre site web est démarré et le profileur commence à collecter des données.The Web site is started and the profiler starts to collect data. Utilisez votre application, puis fermez le navigateur.Exercise your application and then close the browser. Pour arrêter le profilage, appuyez sur la touche Entrée dans la fenêtre d’invite de commandes.To stop profiling, press the Enter key in the command prompt window.

Note

Par défaut, l’invite de commandes ne réapparaît pas après une commande vsperfaspnetcmd.By default, the command prompt does not return after a vsperfaspnetcmd command. Vous pouvez utiliser l’option /nowait pour forcer le retour de l’invite de commandes.You can use the /nowait option to force the command prompt to return. Consultez Utiliser l’option /NoWait.See Use the /NoWait option.

Pour collecter des statistiques d’application à l’aide de la méthode d’échantillonnageTo collect application statistics by using the sampling method

L’échantillonnage est la méthode de profilage par défaut de l’outil VSPerfASPNETCmd et il n’est pas nécessaire de le spécifier sur la ligne de commande.Sampling is the default profiling method of VSPerfASPNETCmd tool and does not have to be specified on the command line. La ligne de commande suivante collecte les statistiques de l’application web spécifiée :The following command line collects application statistics from the specified Web application:

vsperfaspnetcmd URL_site_webvsperfaspnetcmd websiteUrl

Pour collecter les données de minutage détaillées en utilisant la méthode d’instrumentationTo collect detailed timing data by using the instrumentation method

Utilisez la ligne de commande suivante pour collecter les données de minutage détaillées pour une application web ASP.NETASP.NET compilée dynamiquement :Use the following command line to collect detailed timing data from a dynamically compiled ASP.NETASP.NET Web application:

vsperfaspnetcmd /trace URL_site_webvsperfaspnetcmd /trace websiteUrl

Si vous souhaitez profiler des fichiers .dll compilés statiquement dans votre application web, vous devez instrumenter les fichiers à l’aide de l’outil en ligne de commande VSInstr.If you want to profile statically compiled .dll files in your Web application, you must instrument the files by using the VSInstr command-line tool. La commande vsperfaspnetcmd /trace inclut alors les données des fichiers instrumentés.The vsperfaspnetcmd /trace command will include data from the instrumented files.

Pour collecter des données de mémoire .NETTo collect .NET memory data

L’option mémoire/mémoire collecte les données relatives à l’allocation d’objets dans la mémoire .NET et peut collecter des données sur la durée de vie de ces objets.The /Memory option collects data about the allocation of objects in .NET memory and can collect data about the lifetime of those objects. La collecte des données d’allocation est le mode par défaut de l’option de données /Memory et il n’est pas nécessaire de la spécifier sur la ligne de commande.Allocation data collection is the default mode of the /Memory data option and does not have to be specified on the command line.

vsperfaspnetcmd /memory URL_site_webvsperfaspnetcmd /memory websiteUrl

Utilisez le paramètre lifetime pour collecter les données de durée de vie des objets en plus des données d’allocation :Use the Lifetime parameter to collect object lifetime data in addition to the allocation data:

vsperfaspnetcmd /memory:lifetime URL_site_webvsperfaspnetcmd /memory:lifetime websiteUrl

Vous pouvez également utiliser l’option /Trace pour inclure les informations de minutage détaillées avec les données de mémoire .NET :You can also use the /Trace option to include detailed timing information with the .NET memory data:

vsperfaspnetcmd /memory[:lifetime] /tracewebsiteUrlvsperfaspnetcmd /memory[:lifetime] /tracewebsiteUrl

Pour collecter les données d’interaction de coucheTo collect tier interaction data

Warning

Pour collecter des données de profilage d’interaction de couche (TIP), vous pouvez utiliser n’importe quelle édition de Visual Studio.Tier interaction profiling (TIP) data 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.

Pour collecter des données TIP sur Windows 8 ou Windows Server 2012, vous devez utiliser l’option d’instrumentation (/trace).To collect TIP data on Windows 8 or Windows Server 2012, you must use the instrumentation (/trace) option.

Pour collecter les données d’interaction de couche avec les données d’échantillonnage :To collect tier interaction data with sampling data:

vsperfaspnetcmd /tip websiteUrlvsperfaspnetcmd /tip websiteUrl

Pour collecter les données d’interaction de couche avec les données d’instrumentation :To collect tier interaction data with instrumentation data:

vsperfaspnetcmd /trace /tip URL_site_webvsperfaspnetcmd /trace /tip websiteUrl

Pour collecter les données d’interaction de couche avec les données de mémoire .NET :To collect tier interaction data with .NET memory data:

vsperfaspnetcmd /memory[:lifetime] /tipwebsiteUrlvsperfaspnetcmd /memory[:lifetime] /tipwebsiteUrl

Utilisation de l’option /NoWaitUsing the /NoWait option

Par défaut, l’invite de commandes ne réapparaît pas après une commande vsperfaspnetcmd.By default, the command prompt does not return after a vsperfaspnetcmd command. Vous pouvez utiliser l’option de syntaxe suivante pour forcer le retour de l’invite de commandes.You can use the following syntax option to force the command prompt to return. Vous pouvez alors effectuer d’autres opérations dans la fenêtre d’invite de commandes.You can then perform other operations in the command prompt window. Pour terminer le profilage, utilisez l’option /shutdown dans une commande vsperfaspnetcmd distincte.To end profiling, use the /shutdown option in a separate vsperfaspnetcmd command.

Pour démarrer le profilage :To begin profiling:

vsperfaspnetcmd [/Options] /nowaitwebsiteUrlvsperfaspnetcmd [/Options] /nowaitwebsiteUrl

Pour terminer le profilage :To end profiling:

vsperfaspnetcmd /shutdown URL_site_webvsperfaspnetcmd /shutdown websiteUrl

Options supplémentairesAdditional options

Vous pouvez ajouter les options suivantes aux commandes répertoriées plus haut dans cette section, excepté la commande vsperfaspnetcmd /shutdown.You can add any of the following options to the commands listed earlier in this section, except the vsperfaspnetcmd /shutdown command.

OptionOption DescriptionDescription
/Output: VspFile/Output: VspFile Par défaut, le fichier de données de profilage (.vsp) est créé dans le répertoire actif avec le nom de fichier PerformanceReport.vsp.By default, the profiling data (.vsp) file is created in the current directory with the file name PerformanceReport.vsp. Utilisez l’option /output pour spécifier un autre emplacement, le nom du fichier ou les deux.Use the /output option to specify a different location, file name, or both.
/PackSymbols:Off/PackSymbols:Off Par défaut, VsPerfASPNETCmd incorpore les symboles (noms de fonctions et de paramètres, etc.) dans le fichier .vsp.By default, VsPerfASPNETCmd embeds symbols (function and parameter names, etc.) in the .vsp file. L’incorporation des symboles peut rendre le fichier de données de profilage très volumineux.Embedding the symbols can make the profiling data file very large. Si vous devez accéder aux fichiers .pdb qui contiennent les symboles quand vous analysez les données, utilisez l’option /packsymbols:off pour désactiver l’incorporation des symboles.If you will have access to the .pdb files that contain the symbols when you analyze the data, use the /packsymbols:off option to disable the embedding of the symbols.