Utilitário de linha de comando da Visualização Simultânea (CVCollectionCmd)
É possível usar o utilitário de linha de comando do Visualização Simultânea (CVCollectionCmd.exe) para coletar rastreamentos na linha de comando para que seja possível exibi-los na Visualização Simultânea do Visual Studio. As ferramentas podem ser usadas em computadores que não tenham o Visual Studio instalado.
Observação
A Visualização Simultânea é uma extensão opcional. (Anteriormente, ela havia sido incluída no Visual Studio.) Você pode baixar as ferramentas de coleção do Visualizador Simultâneo para Visual Studio no Centro de Download.
Baixar o utilitário de linha de comando da Visualização Simultânea
Para baixar e instalar o utilitário de linha de comando, acesse Ferramentas de Coleção do Visualizador Simultâneo 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 usando CVCollectionCmd
Você pode coletar um rastreamento iniciando o aplicativo com CVCollectionCmd ou se conectando a ele. Consulte a referência aos comandos abaixo para ver as 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 os parâmetros no utilitário de linha de comando, digite isto no prompt de comando:
CvCollectionCmd /?
| Opção | Descrição | Parâmetros | Valores retornados |
|---|---|---|---|
| Consulta | Retorna se a coleta pode ser iniciada. | Nenhum | 0 se a coleta estiver pronta para começar. 1 se a coleta já está em andamento. 2 se a coleta não estiver em andamento, mas uma ou mais sessões ETW necessárias já estiverem habilitadas. |
| Inicializar | Executa o processo especificado na Visualização Simultânea. | O caminho do executável. | 0 se a execução foi bem-sucedida. 1 se a execução falhou porque não foi possível iniciar o aplicativo de destino. 13 se a execução falhou porque CVCollectionCmd não tem permissões suficientes para gravar no diretório de saída especificado. |
| Anexar | Começa coletando um rastreamento em todo o sistema. Do contrário, se conecta a um processo, se algum for especificado. | Nenhum. | 0 se o anexo for bem-sucedido. 1 se o anexo falhou porque o processo especificado é inválido ou ambíguo. 13 se o anexo falhou porque CVCollectionCmd não tem permissões suficientes para gravar no diretório de saída especificado. |
| Detach | Para a coleta. | Nenhum. | 0 se a desanexação for bem-sucedida. 1 se a desanexação falhou porque a coleta não está em andamento no momento. 2 se a desanexação falhou porque a coleta não pode ser parada. |
| Analisar | Analisa o rastreamento especificado. | O caminho completo do arquivo CVTrace. | 0 se a análise for bem-sucedida. 1 se a análise não puder ser iniciada porque o rastreamento especificado estava em todo o sistema, mas sem um processo de destino especificado. 2 se a análise não puder ser iniciada porque o rastreamento não estava em todo o sistema e um processo foi especificado. 3 se a análise falhou porque o processo especificado é inválido. 4 se a análise falhou porque o arquivo CVTrace especificado é inválido. |
| LaunchArgs | Especifica os argumentos executáveis de destino. Essa opção só se aplica ao comando Inicializar. | Os argumentos de linha de comando para o aplicativo. | Nenhum. |
| Outdir | Especifica o diretório no qual os arquivos de rastreamento serão salvos. Aplica-se aos comandos Inicializar e Anexar. | Um caminho do diretório ou relativo. | Nenhum. |
| Processar | Especifica o processo a ser conectado quando o comando Anexar é executado ou o processo em um rastreamento a ser analisado quando o comando Analisar é executado. Aplica-se aos comandos Anexar e Analisar. | A PID ou o nome do processo. | Nenhum. |
| Config | Especifica o caminho do arquivo de configuração, se você quiser configurações de coleta diferentes das configurações padrão. Aplica-se aos comandos Inicializar, Anexar e Analisar. | O caminho do diretório ou relativo do arquivo de configuração XML. | Nenhum. |
Personalizar as definições de configuração
Se você usar CVCollectionCmd para coletar rastreamentos e quiser personalizar as configurações de coleta, use um arquivo de configuração para especificá-las.
Observação
Ao usar o Visual Studio para coletar rastreamentos, não modifique diretamente o arquivo de configuração. Em vez disso, use a caixa de diálogo Configurações Avançadas para modificar as configurações.
Para modificar configurações de coleta, crie um arquivo de configuração no computador em que o utilitário CVCollectionCmd será executado. É possível criar o arquivo de configuração do zero ou copiá-lo no computador com o Visual Studio instalado e modificar isso. O arquivo se chama UserConfig.xml e está localizado na pasta AppData Local. Ao executar o utilitário, use a opção Config com o comando Inicializar, Anexar ou Analisar. No parâmetro associado à opção Config, especifique o caminho do arquivo de configuração.
Marcas de arquivo de configuração
O arquivo de configuração se baseia em XML. Seguem as marcas e os valores válidos:
| Marca | Descrição | Valores |
|---|---|---|
| Config | Demarca o arquivo de configuração geral. | Deve conter estes elementos: - MinorVersion - MajorVersion |
| MajorVersion | Especifica a versão principal do arquivo de configuração. | Deve ser 1 para a maioria dos projetos do Visual Studio. Se não for 1, o utilitário não funcionará. |
| MinorVersion | Especifica a versão secundária do arquivo de configuração. | Deve ser 0 para a maioria dos projetos do Visual Studio. Se não for 0, o utilitário não funcionará. |
| IncludeEnvSymbolPath | Define um valor que determina se o caminho do símbolo de ambiente (_NT_SYMBOL_PATH) é usado. | - True - False |
| DeleteEtlsAfterAnalysis | Define um valor que determina se os arquivos ETL são excluídos quando a análise é concluída. | - True - False |
| SymbolPath | Especifica o caminho do servidor de símbolos. Para obter mais informações, consulte Use the Microsoft Symbol Server to obtain debug symbol files (Usar o Servidor de Símbolos da Microsoft para obter arquivos de símbolo de depuração). | Um nome ou uma URL do diretório. |
| Marcadores | Contém a lista de provedores de marcadores. | Pode conter zero ou mais elementos MarkerProvider. |
| MarkerProvider | Especifica um único provedor de marcadores. | Deve conter estes elementos: - Level – GUID - Name Pode conter estes elementos: - Categories - IsEnabled |
| Nível | Define o nível de importância de um MarkerProvider. | - Low - Normal - High - Crítico - Everything |
| Guid | O identificador global exclusivo do provedor de marcadores ETW. | Uma GUID. |
| Nome | Especifica a descrição do provedor de marcadores. | Uma cadeia de caracteres. |
| Categorias | Especifica as categorias coletadas para o provedor de marcadores. | Uma cadeia de caracteres delimitada por vírgula de números ou intervalos de números. |
| IsEnabled | Define um valor que determina se o provedor de marcadores está habilitado para a coleção. | - True - False |
| FilterConfig | Especifica a lista de opções de configuração dos eventos ETW filtrados da coleção. | Pode conter estes elementos: - CollectClrEvents - ClrCollectionOptions - CollectSampleEvents - CollectGpuEvents - CollectFileIO |
| CollectClrEvents | Define um valor que determina se os eventos do CLR serão coletados. | - True - False |
| ClrCollectionOptions | Especifica se é necessário coletar eventos do CLR para aplicativos nativos e se é necessário coletar eventos de encerramento do NGEN. | Pode conter um, ambos ou nenhum destes valores: - CollectForNative - DisableNGenRundown |
| CollectSampleEvents | Define um valor que determina se os eventos de exemplo serão coletados. | - True - False |
| CollectGpuEvents | Define um valor que determina se os eventos gerados por DX serão coletados. | - True - False |
| CollectFileIO | Define um valor que determina se os eventos de E/S do arquivo serão coletados. | - True - False |
| UserBufferSettings | Especifica a lista de parâmetros de configurações de buffer do usuário. | Deve conter estes elementos: - BufferFlushTimer - BufferSize - MinimumBuffers - MaximumBuffers |
| KernelBufferSettings | Especifica a lista de parâmetros de configurações de buffer do kernel. | Deve conter estes elementos: - BufferFlushTimer - BufferSize - MinimumBuffers - MaximumBuffers |
| BufferFlushTimer | Especifica o temporizador de liberação dos buffers ETW. | Um número inteiro positivo. |
| BufferSize | Quantidade de memória alocada para cada buffer de sessão de rastreamento do evento, em quilobytes. | Um número de 0 a 1.024. |
| MinimumBuffers | O número mínimo de buffers alocados para o pool de buffers da sessão de rastreamento do evento. | Um número inteiro positivo maior ou igual a duas vezes o número de núcleos lógicos. |
| MaximumBuffers | O número máximo de buffers alocados para o pool de buffers da sessão de rastreamento do evento. | Um número maior ou igual a MinimumBuffers. |
| JustMyCode | Especifica a lista de diretórios Habilitar Apenas Meu Código. | Uma lista de zero ou mais elementos MyCodeDirectory. |
| MyCodeDirectory | Especifica um diretório que contém o código. | Um caminho absoluto. |
Exemplo
Em vez de criar um arquivo de configuração desde o início, é possível copiar o exemplo a seguir e modificá-lo para atender aos 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>