Procédure pas à pas : profilage de la ligne de commande à l'aide de l'instrumentation
Cette procédure pas à pas vous indique comment profiler une application autonome .NET Framework pour collecter des données de temporisation détaillées et des informations sur le nombre d'appels à l'aide de la méthode d'instrumentation des outils de profilage.Dans cette procédure pas à pas, vous effectuerez les tâches suivantes :
Utiliser l'outil en ligne de commande VSInstr pour générer des binaires instrumentés.
Utiliser l'outil VSPerfCLREnv pour définir les variables d'environnement afin de collecter des données de profilage .NET.
Utiliser l'outil VSPerfCmd pour collecter des données de profilage.
Utiliser l'outil VSPerfReport pour créer des rapports basés sur des fichiers des données de profilage.
Composants requis
Visual Studio Application Lifecycle Management
Compréhension intermédiaire de C#
Compréhension intermédiaire de l'utilisation des outils en ligne de commande
Une copie de PeopleTrax, exemple (outils de profilage)
Pour utiliser les informations fournies par le profilage, il est préférable d'avoir à disposition des informations de symboles de débogage.Pour plus d’informations, consultez Comment : référencer les informations de symboles Windows.
Profilage de la ligne de commande à l'aide de la méthode d'instrumentation
L'instrumentation est une méthode de profilage par laquelle les versions spécialement générées des binaires profilés contiennent des fonctions de sonde qui collectent des informations de durée au niveau de l'entrée et de la sortie sur les fonctions d'un module instrumenté.Étant donné que cette méthode de profilage est plus importante que l'échantillonnage, elle entraîne une plus grande quantité de charge mémoire.Les binaires instrumentés sont également plus volumineux que les versions de débogage ou release et ne sont pas conçus pour le déploiement.
[!REMARQUE]
N'envoyez pas de binaires instrumentés à vos clients.En effet, ils peuvent présenter plusieurs risques.Ils contiennent des informations facilitant l'ingénierie à rebours de votre application et comportant donc des risques de sécurité.
Pour profiler l'application PeopleTrax à l'aide de la méthode d'instrumentation
Installez l'exemple d'application PeopleTrax et générez la version Release.
Ouvrez une fenêtre d'invite de commandes et ajoutez le répertoire Outils de profilage à la variable d'environnement Path locale.
Remplacez le répertoire de travail par celui qui contient les binaires PeopleTrax.
Créez un répertoire pour contenir les rapports basés sur des fichiers.Tapez la commande suivante :
md Reports
Utilisez l'outil en ligne de commande VSInstr pour instrumenter les binaires dans l'application.Tapez les commandes suivantes sur des lignes de commande distinctes :
VSInstr PeopleTrax.exe VSInstr PeopleTrax.exe VSInstr People.dll VSInstr Person.dll VSInstr Operation.dll
Remarque Par défaut, VSInstr enregistre une sauvegarde non instrumentée du fichier d'origine.Le nom du fichier de sauvegarde a l'extension .orig.Par exemple, la version d'origine de « MyApp.exe » serait enregistrée en tant que « MyApp.exe.orig ».
Tapez la commande suivante pour définir les variables d'environnement appropriées :
VsPerfCLREnv /traceon
Pour démarrer le profileur, tapez la commande suivante :
VsPerfCmd /start:trace /output:Reports\Report.vsp
Après avoir démarré le profileur en mode de suivi, exécutez la version instrumentée du processus PeopleTrax.exe pour collecter des données.
La fenêtre d'application PeopleTrax s'affiche.
Cliquez sur Get People.
La grille de données PeopleTrax est remplie avec les données.
Cliquez sur Exporter les données.
Le Bloc-notes démarre et affiche un nouveau fichier qui contient une liste de personnes de l'application PeopleTrax.
Fermez le Bloc-notes, puis l'application PeopleTrax.
Arrêtez le profileur.Tapez la commande suivante :
VSPerfCmd /shutdown
Tapez la commande suivante pour réinitialiser les variables d'environnement :
VSPerfCLREnv /off
Utilisez l'outil VSPerfReport pour générer des fichiers de rapports .csv (valeurs séparées par des virgules).Type :
VSPerfReport Reports\Report.vsp /output:Reports /summary:all
Vous pouvez analyser les rapports générés dans un tableur ou utiliser l'IDE de Visual Studio pour analyser les données de profilage dans le fichier Report.vsp.Pour plus d’informations, consultez Analyse des données des outils de profilage.
Voir aussi
Référence
Concepts
Vue d'ensemble de la session de performance des outils de profilage
Utilisation des outils de profilage à partir de la ligne de commande
Fonctionnement des valeurs de données d'échantillonnage dans des outils de profilage