Partager via


Utilitaire en ligne de commande du visualiseur concurrentiel (CVCollectionCmd)

Vous pouvez utiliser l’utilitaire en ligne de commande du visualiseur concurrentiel (CVCollectionCmd.exe) pour collecter des traces à partir de la ligne de commande et les afficher dans le visualiseur concurrentiel pour Visual Studio. Vous pouvez utiliser ces outils sur des ordinateurs sur lesquels Visual Studio n'est pas installé.

Remarque

Le visualiseur concurrentiel est une extension facultative. (il était autrefois inclus dans Visual Studio). Vous pouvez télécharger les Outils de collecte du visualiseur concurrentiel pour Visual Studio à partir du Centre de téléchargement.

Télécharger l’utilitaire en ligne de commande du visualiseur concurrentiel

Pour télécharger et installer l’utilitaire en ligne de commande, accédez aux outils de collecte du visualiseur concurrentiel pour Visual Studio , puis suivez les instructions. Par défaut, CVCollectionCmd.exe est installé dans %ProgramFiles%\Microsoft Concurrency Visualizer Collection Tools\ (%ProgramFiles(x86)%\Microsoft Concurrency Visualizer Collection Tools\ sur les ordinateurs x64).

Recueillir une trace avec CVCollectionCmd

Vous pouvez recueillir une trace en démarrant l’application avec CVCollectionCmd ou en vous y attachant. Pour plus d’informations sur les options, consultez ci-dessous les informations de référence sur les commandes. Par exemple

<Path>CVCollectionCmd /launch c:\myapp\myapp.exe /outdir c:\myapp\data

Commandes et paramètres

Pour obtenir de l’aide sur les commandes et paramètres dans l’utilitaire en ligne de commande, tapez ce qui suit à l’invite de commandes :

CvCollectionCmd /?

Option Description Paramètres Valeurs de retour
Requête Retourne une valeur qui indique si la collecte peut démarrer. None 0 si la collecte peut démarrer.

1 si la collecte est déjà en cours.

2 si la collecte n’est pas en cours, mais qu’une ou plusieurs des sessions ETW nécessaires sont déjà activées.
Lancer Exécute le processus spécifié sous le Visualiseur concurrentiel. Chemin de l’exécutable. 0 si l’exécution a réussi.

1 si l’exécution a échoué en raison de l’impossibilité de démarrer l’application cible.

13 si l’exécution a échoué en raison des autorisations de CVCollectionCmd, insuffisantes pour écrire dans le répertoire de sortie spécifié.
Joindre Commence la collecte d’une trace à l’échelle du système ; sinon, établit une liaison avec un processus si vous en avez spécifié un. Aucun. 0 si l’attachement a abouti.

1 si l’attachement a échoué en raison de la non validité et du caractère ambigu du processus spécifié.

13 si l’attachement a échoué en raison des autorisations de CVCollectionCmd, insuffisantes pour écrire dans le répertoire de sortie spécifié.
Detach Arrête la collecte. Aucun. 0 si le détachement a réussi.

1 si le détachement a échoué, car la collecte n’est pas en cours.

2 si le détachement a échoué pour cause d’impossibilité d’arrêter la collecte.
Analyser Analyse la trace spécifiée. Chemin du fichier CVTrace. 0 si l’analyse a abouti.

1 si l’analyse n’a pas pu démarrer, car la trace spécifiée était à l’échelle du système, mais aucun processus cible n’a été spécifié.

2 si l’analyse n’a pas pu démarrer, car la trace n’était pas à l’échelle du système et un processus a été spécifié.

3 si l’analyse a échoué parce que le processus spécifié n’est pas valide.

4 si l’analyse a échoué en raison de la non validité du fichier CVTrace spécifié.
LaunchArgs Spécifie les arguments exécutables cibles. Cette option s’applique uniquement à la commande Launch. Arguments en ligne de commande de l’application. Aucun.
Outdir Spécifie le répertoire dans lequel enregistrer les fichiers de trace. S’applique aux commandes Launch et Attach. Chemin d’un répertoire ou chemin relatif. Aucun.
Processus Spécifie le processus auquel s’attacher en cas d’exécution de la commande Attach ou le processus d’une trace à analyser en cas d’exécution de la commande Analyze. S’applique aux commandes Attach et Analyze. PID ou nom du processus. Aucun.
Config Spécifie le chemin du fichier de configuration, si vous souhaitez appliquer des paramètres de collecte autres que les paramètres par défaut. S’applique aux commandes Launch, Attach et Analyze. Chemin du répertoire ou chemin relatif du fichier de configuration XML. Aucun.

Personnaliser les paramètres de configuration

Si vous utilisez CVCollectionCmd pour recueillir des traces et que vous voulez personnaliser les paramètres de collecte, utilisez un fichier de configuration pour les spécifier.

Notes

Quand vous utilisez Visual Studio pour recueillir des traces, ne modifiez pas directement le fichier de configuration. Au lieu de cela, utilisez la boîte de dialogue Paramètres avancés pour modifier les paramètres.

Pour modifier les paramètres de collecte, créez un fichier de configuration sur l’ordinateur où vous exécuterez l’utilitaire CVCollectionCmd. Vous pouvez créer ce fichier de configuration de toutes pièces ou copier celui qui se trouve sur l’ordinateur où Visual Studio est installé et le modifier. Le fichier se nomme UserConfig.xml et se trouve dans le dossier AppData Local. Quand vous exécutez l’utilitaire, utilisez l’option Config avec la commande Launch, Attach ou Analyze. Dans le paramètre associé à l’option Config, spécifiez le chemin du fichier de configuration.

Balises du fichier config

Le fichier de configuration est basé sur la norme XML. Voici les balises et les valeurs valides :

Tag Description Valeurs
Config Délimite le fichier de configuration dans son ensemble. Doit contenir les éléments suivants :

- MinorVersion
- MajorVersion
MajorVersion Spécifie la version majeure du fichier de configuration. Doit être 1 pour la plupart des projets Visual Studio. Si la valeur est différente de 1, l’utilitaire ne fonctionne pas.
MinorVersion Spécifie la version mineure du fichier de configuration. Doit être 0 pour la plupart des projets Visual Studio. Si la valeur est différente de 0, l’utilitaire ne fonctionne pas.
IncludeEnvSymbolPath Définit une valeur qui détermine si le chemin du symbole d’environnement (_NT_SYMBOL_PATH) est utilisé. - True
- False
DeleteEtlsAfterAnalysis Définit une valeur qui détermine si les fichiers ETL sont supprimés une fois l’analyse terminée. - True
- False
SymbolPath Spécifie le chemin du serveur de symboles. Pour plus d’informations, consultez Utiliser le serveur de symboles Microsoft pour obtenir des fichiers de symboles de débogage. Nom de répertoire ou URL.
Marqueurs Contient la liste des fournisseurs de marqueurs. Peut contenir zéro, un ou plusieurs éléments MarkerProvider.
MarkerProvider Spécifie un fournisseur de marqueurs unique. Doit contenir les éléments suivants :

- Level
- GUID
- Name

Peut contenir les éléments suivants :

- Categories
- IsEnabled
Level Définit le niveau d’importance d’un MarkerProvider. - Low
- Normal
- High
- Critique
- Everything
Guid Identificateur global unique du fournisseur de marqueurs ETW. GUID.
Nom Spécifie la description du fournisseur de marqueurs. Chaîne.
Catégories Spécifie les catégories recueillies pour le fournisseur de marqueurs. Chaîne de nombres ou de plages de nombres délimitée par des virgules.
IsEnabled Définit une valeur qui détermine si le fournisseur de marqueurs est activé pour la collecte. - True
- False
FilterConfig Spécifie la liste d’options de configuration des événements ETW filtrés à partir de la collecte. Peut contenir les éléments suivants :

- CollectClrEvents
- ClrCollectionOptions
- CollectSampleEvents
- CollectGpuEvents
- CollectFileIO
CollectClrEvents Définit une valeur qui détermine si les événements CLR sont recueillis. - True
- False
ClrCollectionOptions Spécifie s’il faut recueillir les événements CLR pour les applications natives et s’il faut recueillir les événements d’arrêt NGEN. Peut contenir une de ces valeurs, les deux ou aucune :

- CollectForNative
- DisableNGenRundown
CollectSampleEvents Définit une valeur qui détermine si des exemples d’événements sont recueillis. - True
- False
CollectGpuEvents Définit une valeur qui détermine si les événements générés par DX sont recueillis. - True
- False
CollectFileIO Définit une valeur qui détermine si les événements d’E/S de fichier sont recueillis. - True
- False
UserBufferSettings Spécifie la liste de paramètres de mémoire tampon utilisateur. Doit contenir les éléments suivants :

- BufferFlushTimer
- BufferSize
- MinimumBuffers
- MaximumBuffers
KernelBufferSettings Spécifie la liste des paramètres de mémoire tampon du noyau. Doit contenir les éléments suivants :

- BufferFlushTimer
- BufferSize
- MinimumBuffers
- MaximumBuffers
BufferFlushTimer Spécifie l’horloge de vidage des mémoires tampons ETW. Entier positif.
BufferSize Quantité de mémoire allouée à chaque mémoire tampon de session de suivi des événements, en kilo-octets. Nombre compris entre 0 et 1 024.
MinimumBuffers Nombre minimal de mémoires tampons allouées pour le pool de mémoires tampons de la session de suivi des événements. Entier positif supérieur ou égal à deux fois le nombre de cœurs logiques.
MaximumBuffers Nombre maximal de mémoires tampons allouées pour le pool de mémoires tampons de la session de suivi des événements. Nombre supérieur ou égal à MinimumBuffers.
JustMyCode Spécifie la liste des répertoires Just My Code. Liste de zéro, un ou plusieurs éléments MyCodeDirectory.
MyCodeDirectory Spécifie un répertoire qui contient votre code. Chemin absolu.

Exemple

Au lieu de créer un fichier de configuration de toutes pièces, vous pouvez copier l’exemple suivant et le modifier en fonction de vos besoins.

<?xml version="1.0"?>
<LocalConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" MajorVersion="1" MinorVersion="0">

  <IncludeEnvSymbolPath>true</IncludeEnvSymbolPath>

  <DeleteEtlsAfterAnalysis>true</DeleteEtlsAfterAnalysis>

  <TraceLocation>C:\traces</TraceLocation>

  <SymbolPath>http://symweb</SymbolPath>

  <Markers>
    <MarkerProvider Name="Default" Guid="8d4925ab-505a-483b-a7e0-6f824a07a6f0" Level="Low" />
    <MarkerProvider Name="TPL" Guid="2e5dba47-a3d2-4d16-8ee0-6671ffdcd7b5" Level="Normal" />
    <MarkerProvider Name="TPL Dataflow" Guid="16f53577-e41d-43d4-b47e-c17025bf4025" Level="Normal" />
    <MarkerProvider Name="TPL Synchronization" Guid="ec631d38-466b-4290-9306-834971ba0217" Level="Normal" />
    <MarkerProvider Name="PLINQ" Guid="159eeeec-4a14-4418-a8fe-faabcd987887" Level="Normal" />
    <MarkerProvider Name="Concurrency Runtime" Guid="f7b697a3-4db5-4d3b-be71-c4d284e6592f" Level="Normal" />
    <MarkerProvider Name="Scenario Markers" Guid="fb9244c9-f23a-4966-8a9c-97a51f8c355b" Level="Low" />

    <!-- The IsEnabled and Categories elements are optional -->
    <MarkerProvider Name="myMarker1" Guid="d0dbb3a3-895c-4ce6-96d9-28f69d664dc3" Level="Critical" IsEnabled="false" Categories="0,1,3-5,8" />
    <MarkerProvider Name="myMarker2" Guid="03452127-a617-4302-9e30-c0d10442e4ee" Level="Low" IsEnabled="false" Categories="0,1,3-5,8-10,11-13" />
  </Markers>

  <FilterConfig>
    <CollectClrEvents>true</CollectClrEvents>
    <ClrCollectionOptions>CollectForNative DisableNGenRundown</ClrCollectionOptions>
    <CollectSampleEvents>true</CollectSampleEvents>
    <CollectGpuEvents>true</CollectGpuEvents>
    <CollectFileIO>true</CollectFileIO>
  </FilterConfig>

  <UserBufferSettings>
    <BufferFlushTimer>0</BufferFlushTimer>
    <BufferSize>256</BufferSize>
    <MinimumBuffers>512</MinimumBuffers>
    <MaximumBuffers>1024</MaximumBuffers>
  </UserBufferSettings>

  <KernelBufferSettings>
    <BufferFlushTimer>0</BufferFlushTimer>
    <BufferSize>256</BufferSize>
    <MinimumBuffers>512</MinimumBuffers>
    <MaximumBuffers>1024</MaximumBuffers>
  </KernelBufferSettings>

  <!-- List of MyCodeDirectory directories -->
  <JustMyCode>
    <MyCodeDirectory>C:\myBinaries1</MyCodeDirectory>
    <MyCodeDirectory>C:\myBinaries2</MyCodeDirectory>
  </JustMyCode>
</LocalConfig>