Udostępnij za pośrednictwem


Narzędzie wiersza polecenia Concurrency Visualizer (CVCollectionCmd)

Możesz użyć narzędzia wiersza polecenia Concurrency Visualizer (CVCollectionCmd.exe), aby zbierać ślady z wiersza polecenia, aby można je było wyświetlić w wizualizatorze współbieżności dla programu Visual Studio. Narzędzia mogą być używane na komputerach, na których nie zainstalowano programu Visual Studio.

Uwaga

Wizualizator współbieżności jest opcjonalnym rozszerzeniem. (Wcześniej była ona zawarta w programie Visual Studio). Narzędzia kolekcji Concurrency Visualizer dla programu Visual Studio można pobrać z Centrum pobierania.

Pobierz narzędzie wiersza polecenia Concurrency Visualizer

Aby pobrać i zainstalować narzędzie wiersza polecenia, przejdź do narzędzia Concurrency Visualizer Collection Tools for Visual Studio i postępuj zgodnie z instrukcjami. Domyślnie plik CVCollectionCmd.exe jest zainstalowany w folderze %ProgramFiles%\Microsoft Concurrency Visualizer Collection Tools\ (%ProgramFiles(x86)%\Microsoft Concurrency Visualizer Collection Tools\ na komputerach x64.

Zbieranie śladu za pomocą klasy CVCollectionCmd

Możesz zebrać ślad, uruchamiając aplikację za pomocą cvCollectionCmd lub dołączając do niej. Aby uzyskać opcje, zapoznaj się z poniższymi odwołaniami do poleceń. Na przykład

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

Polecenia i parametry

Aby uzyskać pomoc dotyczącą poleceń i parametrów w narzędziu wiersza polecenia, wpisz to w wierszu polecenia:

CvCollectionCmd /?

Opcja Opis Parametry Wartości zwracane
Query Zwraca, czy można uruchomić kolekcję. Brak 0, jeśli kolekcja jest gotowa do uruchomienia.

1, jeśli kolekcja jest już w toku.

2, jeśli kolekcja nie jest w toku, ale co najmniej jedna z wymaganych sesji ETW jest już włączona.
Launch Uruchamia określony proces w ramach wizualizatora współbieżności. Ścieżka pliku wykonywalnego. 0, jeśli przebieg zakończył się pomyślnie.

1, jeśli uruchomienie nie powiodło się, ponieważ nie można uruchomić aplikacji docelowej.

13, jeśli uruchomienie nie powiodło się, ponieważ CVCollectionCmd ma niewystarczające uprawnienia do zapisu w określonym katalogu wyjściowym.
Dołącz Rozpoczyna zbieranie śladu całego systemu; w przeciwnym razie dołącza się do procesu, jeśli został określony. Brak. 0, jeśli załącznik zakończył się pomyślnie.

1, jeśli załącznik nie powiódł się, ponieważ określony proces jest nieprawidłowy lub niejednoznaczny.

13, jeśli załącznik nie powiódł się, ponieważ CVCollectionCmd ma niewystarczające uprawnienia do zapisu w określonym katalogu wyjściowym.
Odłącz Zatrzymuje zbieranie. Brak. 0, jeśli odłączenie zakończyło się pomyślnie.

1, jeśli odłączenie nie powiodło się, ponieważ kolekcja nie jest obecnie w toku.

2, jeśli odłączenie nie powiodło się, ponieważ nie można zatrzymać kolekcji.
Analiza Analizuje określony ślad. Pełna ścieżka pliku CVTrace. 0, jeśli analiza zakończyła się pomyślnie.

1 jeśli nie można uruchomić analizy, ponieważ określony ślad był w całym systemie, ale nie określono żadnego procesu docelowego.

2 jeśli nie można uruchomić analizy, ponieważ śledzenie nie było całego systemu i został określony proces.

3 jeśli analiza nie powiodła się, ponieważ określony proces jest nieprawidłowy.

4 jeśli analiza nie powiodła się, ponieważ określony plik CVTrace jest nieprawidłowy.
LaunchArgs Określa docelowe argumenty wykonywalne. Ta opcja dotyczy tylko polecenia Uruchom. Argumenty wiersza polecenia dla aplikacji. Brak.
Outdir Określa katalog, w którym mają być zapisywane pliki śledzenia. Dotyczy poleceń Uruchamiania i dołączania. Ścieżka katalogu lub ścieżka względna. Brak.
Przetwarzaj Określa proces dołączania do podczas wykonywania polecenia Dołączanie lub proces w śladzie do analizy po wykonaniu polecenia Analizuj. Dotyczy poleceń Dołączanie i analizowanie. Identyfikator PID lub nazwa procesu. Brak.
Config Określa ścieżkę pliku konfiguracji, jeśli chcesz ustawić ustawienia kolekcji inne niż domyślne. Dotyczy poleceń Uruchamiania, Dołączania i Analizowania. Ścieżka katalogu lub ścieżka względna pliku konfiguracji XML. Brak.

Dostosowywanie ustawień konfiguracji

Jeśli używasz cvCollectionCmd do zbierania śladów i chcesz dostosować ustawienia kolekcji, użyj pliku konfiguracji, aby je określić.

Uwaga

W przypadku zbierania śladów przy użyciu programu Visual Studio nie należy bezpośrednio modyfikować pliku konfiguracji. Zamiast tego użyj okna dialogowego Zaawansowane Ustawienia, aby zmodyfikować ustawienia.

Aby zmodyfikować ustawienia kolekcji, utwórz plik konfiguracji na maszynie, na której zostanie uruchomione narzędzie CVCollectionCmd. Możesz utworzyć plik konfiguracji od podstaw lub skopiować plik konfiguracji na komputerze z zainstalowanym programem Visual Studio i zmodyfikować go. Plik ma nazwę UserConfig.xml i znajduje się w folderze Local AppData. Po uruchomieniu narzędzia użyj opcji Config w połączeniu z poleceniem Uruchom, Dołącz lub Analizuj. W parametrze skojarzonym z opcją Config określ ścieżkę pliku konfiguracji.

Tagi plików konfiguracji

Plik konfiguracji jest oparty na formacie XML. Oto prawidłowe tagi i wartości:

Tagowy opis Wartości
Config Demarcates ogólny plik konfiguracji. Musi zawierać następujące elementy:

- Wersja pomocnicza
- MajorVersion
Wersja główna Określa wersję główną pliku konfiguracji. Musi być 1 dla większości projektów programu Visual Studio. Jeśli nie ma wartości 1, narzędzie nie będzie działać.
Wersja pomocnicza Określa wersję pomocniczą pliku konfiguracji. Musi być 0 dla większości projektów programu Visual Studio. Jeśli nie ma wartości 0, narzędzie nie będzie działać.
IncludeEnvSymbolPath Ustawia wartość określającą, czy używana jest ścieżka symbolu środowiska (_NT_SYMBOL_PATH). -True
-False
DeleteEtlsAfterAnalysis Ustawia wartość określającą, czy pliki ETL są usuwane po zakończeniu analizy. -True
-False
SymbolPath Określa ścieżkę serwera symboli. Aby uzyskać więcej informacji, zobacz Uzyskiwanie plików symboli debugowania za pomocą programu Microsoft Symbol Server. Nazwa katalogu lub adres URL.
Znaczniki Zawiera listę dostawców znaczników. Może zawierać zero lub więcej elementów MarkerProvider.
MarkerProvider Określa pojedynczego dostawcę znacznika. Musi zawierać następujące elementy:

-Poziom
-IDENTYFIKATOR GUID
-Nazwa

Może zawierać następujące elementy:

-Kategorie
-Isenabled
Poziom Ustawia poziom ważności obiektu MarkerProvider. -Niskie
-Normalne
-Wysokiej
- Critical (Krytyczny)
-Wszystko
Identyfikator GUID Globalnie unikatowy identyfikator dostawcy znacznika ETW. Identyfikator GUID.
Nazwisko Określa opis dostawcy znaczników. Ciąg.
Kategorie Określa kategorie zebrane dla dostawcy znaczników. Rozdzielany przecinkami ciąg liczb lub zakresów liczb.
IsEnabled Ustawia wartość określającą, czy dostawca znacznika jest włączony dla kolekcji. -True
-False
FilterConfig Określa listę opcji konfiguracji zdarzeń ETW, które są filtrowane z kolekcji. Może zawierać następujące elementy:

- CollectClrEvents
- ClrCollectionOptions
- CollectSampleEvents
- CollectGpuEvents
- CollectFileIO
CollectClrEvents Ustaw wartość określającą, czy są zbierane zdarzenia CLR. -True
-False
ClrCollectionOptions Określa, czy należy zbierać zdarzenia CLR dla aplikacji natywnych i czy zbierać zdarzenia rundown NGEN. Może zawierać jedną lub żadną z tych wartości:

- CollectForNative
- DisableNGenRundown
CollectSampleEvents Ustawia wartość określającą, czy są zbierane przykładowe zdarzenia. -True
-False
CollectGpuEvents Ustawia wartość określającą, czy zdarzenia generowane przez DX są zbierane. -True
-False
CollectFileIO Ustawia wartość określającą, czy są zbierane zdarzenia we/wy pliku. -True
-False
UserBuffer Ustawienia Określa listę parametrów ustawień buforu użytkownika. Musi zawierać następujące elementy:

- BufferFlushTimer
-Buffersize
- MinimumBuffers
- MaximumBuffers
KernelBuffer Ustawienia Określa listę parametrów ustawień buforu jądra. Musi zawierać następujące elementy:

- BufferFlushTimer
-Buffersize
- MinimumBuffers
- MaximumBuffers
BufferFlushTimer Określa czasomierz opróżniania buforów ETW. Dodatnia liczba całkowita.
Buffersize Ilość pamięci przydzielonej dla każdego buforu sesji śledzenia zdarzeń w kilobajtach. Liczba z zakresu od 0 do 1024.
MinimumBuffers Minimalna liczba buforów przydzielonych dla puli buforów sesji śledzenia zdarzeń. Dodatnia liczba całkowita większa lub równa dwukrotnie liczbie rdzeni logicznych.
Maksymalna wartośćbuffers Maksymalna liczba buforów przydzielonych dla puli buforów sesji śledzenia zdarzeń. Liczba większa lub równa wartości MinimumBuffers.
JustMyCode Określa listę katalogów Just My Code. Lista zera lub większej liczby elementów MyCodeDirectory.
MyCodeDirectory Określa katalog zawierający kod. Ścieżka bezwzględna.

Przykład

Zamiast tworzyć plik konfiguracji od początku, możesz skopiować poniższy przykład, a następnie zmodyfikować go w celu spełnienia wymagań.

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