CounterCounter

L’option Counter collecte les données des compteurs de performance de processeur (matériels).The Counter option collects data from processor (hardware) performance counters.

  • Quand vous utilisez la méthode de profilage par échantillonnage, Counter spécifie le compteur de performance de processeur et le nombre d’événements de compteur à utiliser comme intervalle d’échantillonnage.When you are using the sampling profiling method, Counter specifies the on-chip performance counter and the number of counter events to use as the sampling interval. Vous ne pouvez spécifier qu’un seul compteur si vous utilisez l’échantillonnage.You can specify only one counter when you are using sampling.

  • Quand vous utilisez la méthode de profilage par instrumentation, le nombre d’événements de compteur qui se sont produits dans l’intervalle entre les événements de collecte précédent et actuel est répertorié sous la forme de champs distincts dans les rapports du profileur.When you are using the instrumentation profiling method, the number of counter events that occurred in the interval between the previous and current collection events are listed as separate fields in profiler reports. Vous pouvez spécifier plusieurs options Counter si vous utilisez l’instrumentation.Multiple Counter options can be specified when you are using instrumentation.

    Chaque type de processeur dispose de son propre jeu de compteurs de performance matériels.Each processor type has its own set of hardware performance counters. Le profileur définit un jeu de compteurs de performance génériques qui sont communs à presque tous les processeurs.The profiler defines a set of generic performance counters that are common to almost all processors. Pour répertorier les compteurs génériques et spécifiques au processeur sur votre ordinateur, utilisez la commande VSPerfCmd QueryCounters.To list the generic and processor-specific counters on your computer, use the VSPerfCmd QueryCounters command.

SyntaxeSyntax

VSPerfCmd.exe {/Launch:AppName | /Attach PID} /Counter:Name[,Reload[,FriendlyName]][Options]
VSPerfCmd.exe /Start:Method /Counter:Name[,Reload[,FriendlyName]][/Counter:Name[,Reload[,FriendlyName]]][Options]

ParamètresParameters

Name Nom du compteur.Name The name of the counter. Utilisez l’option VSPerfCmd.exe /QueryCounters pour répertorier les noms des compteurs disponibles sur l’ordinateur.Use the VSPerfCmd.exe /QueryCounters option to list the names of available counters on the computer.

Reload Nombre d’événements de compteur dans l’intervalle d’échantillonnage.Reload The number of counter events in the sampling interval. N’utilisez pas ce paramètre avec la méthode par instrumentation.Do not use with the instrumentation method.

FriendlyName (Facultatif) Chaîne à utiliser à la place de Name dans les en-têtes de colonnes des rapports et des vues du profileur.FriendlyName (Optional) The string to use in place of Name in the column headers of profiler reports and views.

Options obligatoiresRequired options

L’option Counter peut uniquement être utilisée avec l’une des options suivantes :The Counter option can only be used with one of the following options:

Start : Trace Initialise le profileur pour utiliser la méthode d’instrumentation.Start: Trace Initializes the profiler to use the instrumentation method.

Launch : AppName Démarre l’application spécifiée et le profileur.Launch: AppName Starts the specified application and the profiler. Le profileur doit être initialisé pour utiliser la méthode par échantillonnage.The profiler must be initialized to use the sampling method.

Attach : PID Démarre le profileur et l’attache au processus spécifié par l’ID de processus.Attach: PID Starts the profiler and attaches it to the process specified by the process ID. Le profileur doit être initialisé pour utiliser la méthode par échantillonnage.The profiler must be initialized to use the sampling method.

ExempleExample

L’exemple de méthode par échantillonnage montre comment échantillonner une application toutes les 1 000 occurrences du compteur de profileur générique NonHaltedCycles.The sampling method example demonstrates how to sample an application at every 1000 occurrences of the generic profiler counter NonHaltedCycles.

L’exemple de méthode par instrumentation montre comment initialiser le profileur pour collecter les événements de compteur L2InstructionFetches.The instrumentation method example demonstrates how to initialize the profiler to collect L2InstructionFetches counter events. Le nom de compteur L2InstructionFetches est spécifique au processeur.The L2InstructionFetches counter name is specific to the processor.

; Sample Method Example
VSPerfCmd.exe /Start:Sample /Output:TestApp.exe.vsp
VSPerfCmd.exe /Launch:TestApp.exe /Counter:NonHaltedCycles,1000,"Non-Halted Cycles"

;INSTRUMENTATION METHOD EXAMPLE
VSPerfCmd.exe /Start:Trace /Output:TestApp.exe.vsp /Counter:L2InstructionFetches,,"L2 Cache Instruction Fetches"

Voir aussiSee also