Программа командной строки визуализатора параллелизма (CVCollectionCmd)

С помощью программы командной строки визуализатора параллелизма (CVCollectionCmd.exe) можно собирать трассировки из командной строки, чтобы просмотреть их в визуализаторе параллелизма для Visual Studio. Инструменты можно использовать на компьютерах, на которых не установлен Visual Studio.

Скачайте служебную программу визуализатора параллелизма

Чтобы загрузить и установить служебную программу командной строки, перейдите на инструменты сбора данных Visual Studio Concurrency Visualizer и следуйте инструкциям. По умолчанию CVCollectionCmd.exe устанавливается в %ProgramFiles%\Microsoft Concurrency Visualizer Collection Tools\ (%ProgramFiles(x86)%\Microsoft Concurrency Visualizer Collection Tools\ на компьютерах x64).

Сбор трассировки с помощью CVCollectionCmd

Вы можете собирать трассировку, запуская приложение с CVCollectionCmd или подключившись к нему. См. приведённый ниже справочник команд для получения доступных вам опций. Например.

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

Команды и параметры

Чтобы получить справку о командах и параметрах в служебной программе командной строки, введите следующую команду в командной строке:

CvCollectionCmd /?

Настройка параметров конфигурации

Если вы используете CVCollectionCmd для сбора трассировок и хотите настроить параметры коллекции, используйте файл конфигурации для их указания.

Чтобы изменить параметры коллекции, создайте файл конфигурации на компьютере, где будет выполняться служебная программа CVCollectionCmd. Вы можете создать файл конфигурации с нуля или скопировать файл конфигурации на компьютере с установленным и измененным Visual Studio. Файл называется UserConfig.xml и находится в папке Local AppData . При запуске служебной программы используйте параметр Config в сочетании с командой Launch, Attach или Analyze. В параметре, связанном с параметром конфигурации, укажите путь к файлу конфигурации.

Теги файла конфигурации

Файл конфигурации основан на XML. Ниже приведены допустимые теги и значения:

Example

Вместо создания файла конфигурации с самого начала можно скопировать следующий пример, а затем изменить его в соответствии с вашими требованиями.

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