Utilitaire de ligne de commande du visualiseur concurrentiel (CVCollectionCmd)

Vous pouvez utiliser l’utilitaire de ligne de commande du visualiseur concurrentiel (CVCollectionCmd.exe) pour collecter des traces à partir de la ligne de commande afin de pouvoir les afficher dans le visualiseur concurrentiel pour Visual Studio. Les outils peuvent être utilisés sur les ordinateurs qui n’ont pas visual Studio installé.

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

Pour télécharger et installer l’utilitaire de ligne de commande, accédez à Concurrency Visualizer Collection Tools pour Visual Studio et 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).

Collecter une trace avec CVCollectionCmd

Vous pouvez collecter une trace en démarrant l’application avec CVCollectionCmd ou en vous y attachant. Consultez la référence de commande ci-dessous pour connaître vos options. 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 les paramètres dans l’utilitaire de ligne de commande, tapez-le à l’invite de commandes :

CvCollectionCmd / ?

Personnaliser les paramètres de configuration

Si vous utilisez CVCollectionCmd pour collecter des traces et que vous souhaitez personnaliser les paramètres de collection, utilisez un fichier de configuration pour les spécifier.

Pour modifier les paramètres de collection, créez un fichier de configuration sur l’ordinateur sur lequel vous allez exécuter l’utilitaire CVCollectionCmd. Vous pouvez créer le fichier de configuration à partir de zéro, ou copier le fichier de configuration sur l’ordinateur sur lequel Visual Studio est installé et modifié. Le fichier est nommé UserConfig.xml et se trouve dans le dossier AppData local . Lorsque vous exécutez l’utilitaire, utilisez l’option Config conjointement avec la commande Launch, Attach ou Analyze. Dans le paramètre associé à l’option Config, spécifiez le chemin d’accès du fichier de configuration.

Balises de fichier de configuration

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

Example

Au lieu de créer un fichier de configuration à partir du début, vous pouvez copier l’exemple suivant, puis le modifier pour répondre à 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>