Utilitário de linha de comando do Visualizador de Concorrência (CVCollectionCmd)

Você pode usar o utilitário de linha de comando do Visualizador Simultâneo (CVCollectionCmd.exe) para traçar informações da linha de comando, permitindo que você as visualize no Visualizador Simultâneo para o Visual Studio. As ferramentas podem ser usadas em computadores que não têm o Visual Studio instalado.

Faça o download do utilitário de linha de comando do Concurrency Visualizer

Para baixar e instalar o utilitário de linha de comando, acesse As Ferramentas de Coleção de Visualizadores Simultâneos para Visual Studio e siga as instruções. Por padrão, CVCollectionCmd.exe é instalado em %ProgramFiles%\Microsoft Concurrency Visualizer Collection Tools\ (%ProgramFiles(x86)%\Microsoft Concurrency Visualizer Collection Tools\ em computadores x64).

Coletar um rastreamento com CVCollectionCmd

Você pode coletar um rastreamento iniciando o aplicativo com CVCollectionCmd ou anexando a ele. Consulte a referência de comando abaixo para obter suas opções. Por exemplo

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

Comandos e parâmetros

Para obter ajuda sobre os comandos e parâmetros no utilitário de linha de comando, digite-o no prompt de comando:

CvCollectionCmd /?

Personalizar as configurações

Se você usar CVCollectionCmd para coletar rastreamentos e quiser personalizar as configurações da coleção, use um arquivo de configuração para especificá-los.

Para modificar as configurações de coleção, crie um arquivo de configuração no computador em que você executará o utilitário CVCollectionCmd. Você pode criar o arquivo de configuração do zero ou copiar o arquivo de configuração no computador que tem o Visual Studio instalado e modificá-lo. O arquivo é nomeado UserConfig.xml e está localizado na pasta Local AppData . Ao executar o utilitário, use a opção Config em conjunto com o comando Iniciar, Anexar ou Analisar. No parâmetro associado à opção Config, especifique o caminho do arquivo de configuração.

Tags de arquivo de configuração

O arquivo de configuração é baseado em XML. Aqui estão as tags e os valores válidos:

Example

Em vez de criar um arquivo de configuração desde o início, você pode copiar o exemplo a seguir e modificá-lo para atender aos seus requisitos.

<?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>