次の方法で共有

同時実行ビジュアライザー コマンド ライン ユーティリティ (CVCollectionCmd)

  • [アーティクル]

収集し、Visual Studio を持たないマシン上のトレースを処理するには、同時実行制御ビジュアライザーのコマンド ライン ユーティリティ (CVCollectionCmd.exe) を使用できます。同時実行制御ビジュアライザーに表示することができますように、Visual Studio を持つマシン上で収集したトレースを開くことができます。

インストールおよび、ユーティリティを展開します。

Visual Studio DVD からインストールするのには

  1. この DVD には、「同時実行制御ビジュアライザー」という名前の最上位のフォルダーを検索します。

  2. このフォルダーには、concvi_standalonecollection.exe を実行します。

Visual Studio Web インストール ファイルをインストールするのには

  1. ダウンロードしたインストール ファイルを探します。ファイル名はダウンロードの Visual Studio のバージョンに依存します。

  2. コマンド プロンプト ウィンドウを開き、インストール ファイルが格納されているディレクトリに変更します。

  3. コマンドを実行する<install file>/layout、 install fileは、ダウンロードしたファイルの名前です。レイアウト コマンドは、「同時実行制御ビジュアライザー」という名前のフォルダーを作成します。

  4. "同時実行制御ビジュアライザー] フォルダーには、concvi_standalonecollection.exe を実行します。

Visual Studio を持たないコンピューターに展開するには

  1. Concvi_standalonecollection.exe Visual Studio を持つコンピューターを検索します。(前の 2 つの手順を参照してください)。

  2. Concvi_standalonecollection.exe Visual Studio を持たないコンピューターにコピーします。

  3. Concvi_standalonecollection.exe を実行します。

コマンドとパラメーター

使用して、これらのコマンドとパラメーターのヘルプを表示できます。

CvCollectionCmd /?

オプション

Description

パラメーター

戻り値

クエリ

コレクションを開始するかどうかを返します。

なし

コレクションを開始する準備が場合は、0 を返します。

1 の場合、コレクションは既に進行中です。

コレクションの進行状況が 1 つまたは複数の必要なのでがいない場合 2 ETW セッションが既に有効になって。

[起動]

指定されたプロセス同時実行制御ビジュアライザー] を実行します。

実行可能ファイルのパスを指定します。

実行が成功した場合は 0 を返します。

1 の場合は、ターゲット アプリケーションを起動できませんでしたので、実行に失敗しました。

13 の CVCollectionCmd は、指定した出力ディレクトリに書き込むための十分なアクセス許可があるため、実行が失敗した場合します。

[アタッチ]

システム全体にわたるトレースの収集を開始します。 それ以外の場合は、指定されている場合にプロセスをアタッチします。

なし。

接続が成功した場合は 0 を返します。

添付ファイルが指定されたプロセスが無効なまたはあいまいなために失敗した場合は、1。

13 の CVCollectionCmd は、指定した出力ディレクトリに書き込むための十分なアクセス許可があるため、添付ファイルが失敗した場合します。

デタッチ

コレクションを停止します。

なし。

分隊が成功した場合は 0 を返します。

コレクションが現在実行中であるために、分隊を失敗した場合は 1。

コレクションを停止できませんでしたので、分隊を失敗した場合は 2 になります。

分析

指定されたトレースを分析します。

CVTrace ファイルのフル パス。

解析が成功した場合は 0 を返します。

1 の場合、指定されたトレース システム全体が対象のプロセスが指定されていないために、分析を開始できません。

トレースがシステム全体にわたると、プロセスがないために、分析を起動できない場合は 2 が指定されました。

指定されたプロセスが無効なので解析が失敗した場合の 3。

指定された CVTrace ファイルが無効なので解析が失敗した場合 4.

LaunchArgs

ターゲットの実行可能な引数を指定します。このオプションは、起動コマンドにのみ適用されます。

アプリケーションのコマンドライン引数。

なし。

Outdir

トレース ファイルの保存先ディレクトリを指定します。起動と接続のコマンドに適用されます。

ディレクトリのパスまたは相対パス。

なし。

プロセス

Attach コマンドの実行時に、接続先のプロセスまたはプロセス トレースの分析コマンドの実行を分析するを指定します。アタッチと分析のコマンドに適用されます。

PID やプロセスの名前。

なし。

構成

コレクションの設定を既定値以外の場合は、構成ファイルのパスを指定します。起動、接続、および分析のコマンドに適用されます。

ディレクトリのパスまたは XML 構成ファイルの相対パスを指定します。

なし。

構成設定のカスタマイズ

CVCollectionCmd を使用してトレースを収集して、コレクションの設定をカスタマイズする場合は、それらを指定するのには、構成ファイルを使用します。

[!メモ]

Visual Studio を使用してトレースを収集するときは、構成ファイルを直接変更しないようにします。代わりに、使用して、 詳細設定の設定を変更するのには、ダイアログ ボックス。

コレクションの設定を変更するには、CVCollectionCmd ユーティリティを実行するコンピューターで構成ファイルを作成します。Visual Studio のインストール、コンピューターの構成ファイルをコピーして、変更、構成ファイルを最初から作成することができます。ファイルの名前UserConfig.xmlである、 ローカルの AppData フォルダー。ユーティリティを実行すると、構成オプション、起動、接続、または分析コマンドを使用します。構成オプションに関連付けられているパラメーターでは、構成ファイルのパスを指定します。

Hh543788.collapse_all(ja-jp,VS.110).gif構成ファイルのタグ

構成ファイルは XML ベースです。ここでは、有効なタグと値です。

Tag

Description

Values

構成

構成ファイル全体を demarcates します。

これらの要素を含める必要があります。

  • MinorVersion

  • MajorVersion

MajorVersion

構成ファイルのメジャー バージョンを指定します。

1 にする必要がありますVisual Studio 2012プロジェクト。場合は 1 は、このユーティリティは機能しません。

MinorVersion

構成ファイルのマイナー バージョンを指定します。

0 である必要がありますVisual Studio 2012プロジェクト。場合は、0 では、ユーティリティは機能しません。

IncludeEnvSymbolPath

環境のシンボル パス (_NT_SYMBOL_PATH) を使用するかどうかを決定する値を設定します。

  • True

  • False

DeleteEtlsAfterAnalysis

分析が完了すると、ETL ファイルを削除するかどうかを決定する値を設定します。

  • True

  • False

SymbolPath

シンボル サーバーのパスを指定します。詳細についてを参照してくださいデバッグ シンボル ファイルを入手するのには、Microsoft シンボル サーバーの使用。

ディレクトリ名、または URL。

Markers

マーカーのプロバイダーのリストが含まれています。

0 個以上の MarkerProvider 要素を含めることができます。

MarkerProvider

マーカーの 1 つのプロバイダーを指定します。

これらの要素を含める必要があります。

  • [レベル]

  • GUID

  • 名前

これらの要素を含めることができます。

  • [カテゴリ]

  • IsEnabled

[レベル]

重要度のレベルの MarkerProvider を設定します。

  • Low

  • Normal

  • High

  • Critical

  • すべて

Guid

ETW マーカーのプロバイダーのグローバルに一意な識別子。

GUID。

名前

マーカーのプロバイダーの説明を指定します。

文字列

[カテゴリ]

マーカーのプロバイダーが収集するカテゴリを指定します。

数値または数値の範囲をコンマ区切りの文字列。

IsEnabled

コレクションのマーカーのプロバイダーを有効にするかどうかを決定する値を設定します。

  • True

  • False

FilterConfig

コレクションからフィルタ リングは、ETW イベントの構成オプションの一覧を指定します。

これらの要素を含めることができます。

  • CollectClrEvents

  • ClrCollectionOptions

  • CollectSampleEvents

  • CollectGpuEvents

  • CollectFileIO

CollectClrEvents

CLR のイベントが収集されるかどうかを決定する値を設定します。

  • True

  • False

ClrCollectionOptions

ネイティブ アプリケーションを CLR イベントを収集するかどうか、および NGEN の rundown のイベントを収集するかどうかを指定します。

1 つ、両方、またはこれらの値が含まれている可能性があります。

  • CollectForNative

  • DisableNGenRundown

CollectSampleEvents

サンプルのイベントが収集されるかどうかを決定する値を設定します。

  • True

  • False

CollectGpuEvents

DX によって生成されたイベントを収集するかどうかを決定する値を設定します。

  • True

  • False

CollectFileIO

ファイル I/O イベントが収集されるかどうかを決定する値を設定します。

  • True

  • False

UserBufferSettings

ユーザーのバッファー設定のパラメーターの一覧を指定します。

これらの要素を含める必要があります。

  • BufferFlushTimer

  • BufferSize

  • MinimumBuffers

  • MaximumBuffers

KernelBufferSettings

カーネル バッファー設定のパラメーターの一覧を指定します。

これらの要素を含める必要があります。

  • BufferFlushTimer

  • BufferSize

  • MinimumBuffers

  • MaximumBuffers

BufferFlushTimer

ETW のバッファーのフラッシュ タイマーを指定します。

正の整数。

BufferSize

各 kb 単位でのイベント トレース セッション バッファーに割り当てられるメモリの量。

1024 ～ 0 の数値。

MinimumBuffers

イベント トレース セッションのバッファー プールに割り当てられているバッファーの最小数。

正の整数論理コアの数が 2 倍以上。

MaximumBuffers

イベント トレース セッションのバッファー プールに割り当てられているバッファーの最大数です。

MinimumBuffers 以上の数です。

JustMyCode

[マイ コードのみ] のディレクトリのリストを指定します。

0 個以上の MyCodeDirectory 要素の一覧。

MyCodeDirectory

コードが置かれているディレクトリを指定します。

絶対パス。

Hh543788.collapse_all(ja-jp,VS.110).gif例

先頭から構成ファイルを作成するのではなく、次の使用例をコピーし、要件に合わせて変更することができます。

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