Befehlszeilenhilfsprogramm für die Parallelitätsschnellansicht (CVCollectionCmd)

Artikel
06/08/2015

Sie können das Befehlszeilenprogramm Concurrency Visualizer (CVCollectionCmd.exe) verwenden, um die Ablaufverfolgung aus der Befehlszeile zu sammeln und diese in Codezeile für Visual Studio 2013 anzuzeigen.Die Tools können auf Computern verwendet werden, auf denen Visual Studio nicht installiert ist.

Hinweis
Concurrency Visualizer ist eine optionale Erweiterung für Visual Studio 2013.(In einigen Edition früherer Versionen von Visual Studio war Concurrency Visualizer enthalten.) Sie können Concurrency Visualizer von der Visual Studio-Website herunterladen.

Befehlszeilenprogramm Concurrency Visualizer herunterladen

Gehen Sie zum Herunterladen des Befehlszeilenprogramms auf Concurrency Visualizer Collection Tools für Visual Studio 2013 auf der Website Microsoft Download Center und folgen Sie den Anweisungen.Standardmäßig wird CVCollectionCmd.exe in %ProgramFiles%\Microsoft Concurrency Visualizer Collection Tools\ (%ProgramFiles(x86)%\Microsoft Concurrency Visualizer Collection Tools\ auf x64 computers) installiert.

Eine Ablaufverfolgung mit CVCollectionCmd sammeln

Sie können eine Ablaufverfolgung sammeln, indem Sie die App mit CVCollectionCmd starten oder es dieser anhängen.Siehe die Befehlszeilenreferenz unten hinsichtlich Ihrer Optionen.Beispiel:

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

Befehle und Parameter

Wenn Sie Hilfe zu den Befehlen und Parametern im Befehlszeilenprogramm benötigen, geben Sie Folgendes in der Eingabeaufforderung ein:

CvCollectionCmd /?

Option	Beschreibung	Parameter	Rückgabewert
Abfrage	Gibt zurück, ob sich die Auflistung starten lässt.	Keine	0, wenn die Auflistung startbereit ist. 1, wenn die Auflistung bereits läuft. 2, wenn die Auflistung nicht läuft, aber eine oder mehr der erforderlichen ETW-Sitzungen bereit aktiviert ist.
Starten	Führt den festgelegten Prozess unter Concurrency Visualizer aus.	Der Pfad der ausführbaren Datei.	0, wenn das Ausführen erfolgreich war. 1, wenn das Ausführen fehlgeschlagen ist, weil die Zielanwendung nicht gestartet werden konnte. 13, wenn das Ausführen fehlgeschlagen ist, weil CVCollectionCmd keine ausreichenden Berechtigungen für das Schreiben in die festgelegte Ausgabeverzeichnis besitzt.
Anfügen	Beginnt mit dem Erfassen einer systemweiten Ablaufverfolgung; wird ansonsten an einen Prozess angefügt, sofern ein solcher festgelegt wurde.	Keine	0, wenn Anfügen erfolgreich war. 1, wenn das Anfügen fehlgeschlagen ist, weil der festgelegte Prozess ungültig oder mehrdeutig ist. 13, wenn das Anfügen fehlgeschlagen ist, weil CVCollectionCmd nicht ausreichende Berechtigungen für das Schreiben in das festgelegte Ausgabeverzeichnis besitzt.
Trennen	Auflistung wird angehalten.	Keine	0, wenn Trennen erfolgreich war. 1, wenn das Trennen fehlgeschlagen ist, weil die Auflistung aktuell nicht ausgeführt wird. 2, wenn das Trennen fehlgeschlagen ist, weil die Auflistung nicht angehalten werden konnte.
Analysieren	Analysiert die festgelegte Ablaufverfolgung.	Der vollständige Pfad der Datei DVTrace.	0, wenn die Analyse erfolgreich war. 1, wenn die Analyse nicht gestartet werden kann, da die festgelegte Ablaufverfolgung systemweit war, aber kein Zielprozess festgelegt worden ist. 2, wenn die Analyse nicht gestartet werden kann, da die Ablaufverfolgung nicht systemweit war und ein Zielprozess festgelegt worden ist. 3, wenn die Analyse fehlgeschlagen ist, weil der festgelegte Prozess ungültig ist. 4, wenn die Analyse fehlgeschlagen ist, weil die festgelegte Datei CVTrace ungültig ist.
LaunchArgs	Legt die ausführbaren Argumente des Ziels fest.Diese Option gilt nur für den Befehl "Launch".	Die Befehlszeilenargumente für die Anwendung.	Keine
Outdir	Legt das Verzeichnis fest, in dem die Ablaufverfolgungsdateien gespeichert werden sollen.Gilt für die Befehle "Starten" und "Anfügen".	Ein Verzeichnispfad oder ein relativer Pfad.	Keine
Prozess	Legt den anfügenden Prozess fest, wenn der Befehl "Anfügen" ausgeführt wird oder den zu analysierenden Prozesses in einer Ablaufverfolgung, wenn der Befehl "Analysieren" ausgeführt wird.Gilt für die Befehle "Anfügen" und "Analysieren".	PID oder Name des Prozesses.	Keine
Konfigurationen	Legt den Pfad der Konfigurationsdatei fest, wenn Sie andere Auflistungeinstellungen als die standardmäßigen möchten.Gilt für die Befehle "Starten", "Anfügen" und "Analysieren".	Der Verzeichnispfad oder relative Pfad der XML-Konfigurationsdatei.	Keine

Konfigurationseinstellungen anpassen

Wenn Sie CVCollectionCmd für die Auflistung der Ablaufverfolgung verwenden und die Einstellungen anpassen möchten, dann verwenden Sie eine Konfigurationsdatei, um diese festzulegen.

Hinweis
Wenn Sie Visual Studio für die Auflistung der Ablaufverfolgung verwenden, dann verändern Sie die Konfigurationsdatei nicht direkt.Nutzen Sie stattdessen das Dialogfeld Erweiterte Einstellungen dafür.

Erstellen Sie für Änderungen an den Auflistungseinstellung eine Konfigurationsdatei auf dem Rechner, auf dem das Dienstprogramm CVCollectionCmd ausgeführt wird.Sie können die Konfigurationsdatei neu erstellen oder auf den Computer kopieren, auf dem Visual Studio installiert ist und sie anschließend anpassen.Die Datei heißt UserConfig.xml und befindet sich im Ordner Local AppData.Wenn Sie das Dienstprogramm ausführen, verwenden Sie die Option "Config" zusammen mit dem Befehl "Starten", "Anfügen" oder "Analysieren".Geben Sie in dem der Option "Config" zugeordneten Parameter den Pfad zur Konfigurationsdatei an.

Tags der Konfigurationsdatei

Die Konfigurationsdatei ist XML-basiert.Hier sind die gültigen Tags und Werte:

Tag	Beschreibung	Werte
Konfigurationen	Grenzt die gesamte Config-Datei ab.	Muss folgende Elemente enthalten: MinorVersion MajorVersion
MajorVersion	Gibt die Hauptversion der Konfigurationsdatei an.	Muss 1 sein für Visual Studio 2012-Projekte.Wenn nicht 1, dann funktioniert das Dienstprogramm nicht.
MinorVersion	Legt die Nebenversion der Konfigurationsdatei fest.	Muss 0 sein für Visual Studio 2012-Projekte.Wenn nicht 0, dann funktioniert das Dienstprogramm nicht.
IncludeEnvSymbolPath	Legt einen Wert fest, der bestimmt, ob der Umgebungssymbolpfad (_NT_SYMBOL_PATH) verwendet wird.	True False
DeleteEtlsAfterAnalysis	Gibt einen Wert an, der festlegt, ob die ETL-Dateien nach Abschluss der Analyse gelöscht werden.	True False
SymbolPath	Gibt den Pfad des Symbolservers an.Weitere Informationen finden Sie unter Beziehen von Debugsymboldateien über den Microsoft-Symbolserver.	Ein Verzeichnisname oder eine URL.
Marker	Enthält die Liste der Markeranbieter.	Kann null oder mehr MarkerProvider-Elemente enthalten.
MarkerProvider	Gibt einen einzelnen Markeranbieter an.	Muss folgende Elemente enthalten: Ebene GUID Name Kann folgende Elemente enthalten: Kategorien IsEnabled
Ebene	Legt den Wert für die Bedeutung eines MarkerProviders fest.	Niedrig Normal Hoch Kritisch Alles
Guid	Der Globally Unique Identifier des ETW-Markeranbieters.	Ein GUID.
Name	Gibt die Beschreibung des Markeranbieters an.	Eine Zeichenfolge.
Kategorien	Gibt die für den Markeranbieter erfassten Kategorien an.	Eine durch Kommas getrennte Zeichenfolge oder eine Reihe von Zahlen.
IsEnabled	Gibt einen Wert an der festlegt, ob der Markeranbieter für die Auflistung aktiviert ist.	True False
FilterConfig	Gibt die Liste der Konfigurationsoptionen der ETW-Ereignisse an, die aus der Auflistung gefiltert werden.	Kann folgende Elemente enthalten: CollectClrEvents ClrCollectionOptions CollectSampleEvents CollectGpuEvents CollectFileIO
CollectClrEvents	Geben Sie einen Wert an, der festlegt, ob CLR-Ereignisse gesammelt werden.	True False
ClrCollectionOptions	Gibt an, ob CLR-Ereignisse für systemeigene Apps gesammelt werden und ob NGEN-Rundownereignisse erfasst werden sollen.	Kann einen, beide oder keinen der folgenden Werte enthalten: CollectForNative DisableNGenRundown
CollectSampleEvents	Gibt einen Wert an, der festlegt, ob Samplingereignisse gesammelt werden.	True False
CollectGpuEvents	Gibt einen Wert an, der festlegt, ob die von DX erstellten Ereignisse gesammelt werden.	True False
CollectFileIO	Gibt einen Wert an, der festlegt, ob I/O-Ereignisse gesammelt werden.	True False
UserBufferSettings	Gibt die Parameterliste für die Benutzerpuffereinstellungen an.	Muss folgende Elemente enthalten: BufferFlushTimer BufferSize MinimumBuffers MaximumBuffers
KernelBufferSettings	Gibt die Parameterliste für die Kernelpuffereinstellungen an.	Muss folgende Elemente enthalten: BufferFlushTimer BufferSize MinimumBuffers MaximumBuffers
BufferFlushTimer	Gibt den Leerungszeitgeber der ETW-Puffer an.	Eine positive ganze Zahl.
BufferSize	Die jedem Sitzungspuffer für die Ereignisablaufverfolgung zugewiesene Menge an Speicher in Kilobyte.	Eine Zahl von 0 bis 1024.
MinimumBuffers	Die Mindestanzahl an Puffern, die für den Pufferpool der Ereignisablaufverfolgungssitzung zugeordnet sind.	Eine positive ganze Zahl größer oder gleich der doppelten Anzahl logischer Kerne.
MaximumBuffers	Die maximale Anzahl an Puffern, die für den Pufferpool der Ereignisablaufverfolgungssitzung zugeordnet sind.	Ein Zahl größer oder gleich der MinimumBuffers.
JustMyCode	Gibt die Liste der Verzeichnisse "Nur mein Code" an.	Eine Liste von null oder mehr MyCodeDirectory-Elementen.
MyCodeDirectory	Gibt ein Verzeichnis an, das Ihren Code enthält.	Ein absoluter Pfad.

Beispiel

Statt eine Konfigurationsdatei von vorn zu beginnen, können Sie das folgende Beispiel kopieren und es dann an Ihren Bedarf anpassen.

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

Share via