WPR のコマンド ライン オプション
Windows Performance Recorder (WPR) は、シンプルなコマンド ライン インターフェイスを提供します。 WPR の完全な複雑さは、記録プロファイルに埋め込まれています。
[全般] オプション
WPR には、Windows 8.1 以降のバージョンのオペレーティング システムが必要です。
構文
wpr FirstLevelOption [<arguments>] [Additional options [<arguments>]]
追加のヘルプが表示される場合は、次の情報を参照してください:
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
次の FirstLevelOptions を使用できます:
| オプション | 説明 |
|---|---|
| -help | サブレベルのヘルプ情報の一覧を指定します。 |
| -profiles | プロファイルのプロファイル名と説明を列挙します。 |
| -purgecache | 動的シンボル キャッシュを消去します。 |
| -start | 1 つ以上のプロファイルを開始します。 |
| -marker | イベント マーカーを発生します。 |
| -markerflush | (廃止) イベント マーカーを起動し、ワーキング セットをフラッシュします。 |
| -status | アクティブな記録の状態を表示します (該当する場合)。 |
| -profiledetails | イベント マーカーを発生し、ワーキング セットをフラッシュします。 |
| -exportprofile | 組み込みプロファイルをファイルにエクスポートします。 |
| -providers | プロバイダーに関する詳細情報を表示します。 |
| -cancel | WPR によって開始された記録を取り消します (該当する場合)。 |
| - 中止 | WPR によって開始された記録を取り消します (該当する場合)。 |
| -merge | etl ファイルを指定のファイルにマージします。 |
| -flush | WPR によって開始されたログ セッションをフラッシュします (該当する場合)。 |
| -log | イベント ログに保存されたデバッグ情報を構成します。 |
| -disablepagingexecutive | [ページング エグゼクティブを無効化] 設定を変更します。 |
| -heaptracingconfig | [プロセスのヒープ トレース] 設定を変更します。 |
| -snapshotconfig | プロセスのスナップショット設定を変更します。 |
| -capturestateondemand | 現在の記録で構成されているプロバイダーの状態をキャプチャします。 |
| -pmcsources | システムで使用可能な PMU イベントの一覧を照会します。 |
| -pmcsessions | PMU イベントを使用してセッションの一覧を照会します。 |
| -setprofint | サンプリングされたプロファイルの間隔を設定 します。 |
| -profint | 現在のプロファイル間隔に対してクエリを実行します。 |
| -resetprofint | 既定のプロファイル間隔の値を復元します。 |
| -boottrace | autologger/globallogger セッションのレジストリ エントリを構成します。 |
| -enableperiodicsnapshot | 指定した 間隔と 特定のプロセス ID に対して定期的なスナップショットを有効にする。 |
| -disableperiodicsnapshot | 全てのプロセスの [定期的なスナップショット] を無効にします。 |
| -singlesnapshot | 指定したプロセスのオンデマンド スナップショットを取得します。 |
プロファイル
[ プロファイル] オプション には、記録で使用される WPR プロファイルが一覧表示されます。
構文
wpr -profiles [<path>]
次の表では、このオプションに適用できる引数について説明します。 組み込みプロファイルを表示するには、 引数を省略します。
| 引数 | 説明 |
|---|---|
| <path> | トレース プロファイルを含むファイルのパスと名前を示す値を指定します。 例: wpr -profiles “c:\Users\User1\Documents\WPR Files\Custom Profiles\CustomProfile1.wprp” |
スタート
Start オプションは 、1 つ以上のプロファイルを使用して記録を開始します。
構文
wpr -start <profile> [-start <profilen>]... [-filemode] [-recordtempto <temp folder path>] [-onoffscenario <OnOff Transition Type>] [-onoffresultspath <path to which the trace files are saved>] [-onoffproblemdescription <description of the scenario>] [-numiterations <number of iterations for OnOff tracing>]
次の表では、このオプションに適用できる引数について説明します。
| Switch | 説明 |
|---|---|
| <profile> [-start <profilen>]... | 組み込みプロファイルまたはユーザー定義プロファイルへのパスを指定します。 1 つのコマンド ラインで最大 64 のプロファイルを指定できます。各プロファイルは次のように指定されます: <profile> := [<filename.wprp>!]<profile name>[.{light|verbose}] 各プロファイルでは、軽量バージョンまたは冗長バージョン、または両方のバージョンを定義できます。 どちらのオプションも指定しない場合は、プロファイルに軽量バージョンしか含めない限り、冗長バージョンが使用されます。 |
| -shutdown [<KSR>] | セッション情報と記録が再起動時に保持されることを指定します。 Shutdown オプションは、KSR がメモリ モードでのみ機能するファイル モード トレースでのみ機能します。 次の起動時に -stop コマンドを呼び出して、トレースをマージします。 |
| -filemode | 記録がファイル モードで行われることを指定します。 (デフォルトのモードはメモリです)。このオプションを使用すると、データは無制限のファイルに記録され、ディスクがいっぱいになるまでサイズが大きくなる可能性があります。 |
| -recordtempto <一時フォルダ パス> | 記録を保存する一時フォルダー パスを指定します。 |
| -onoffscenario <OnOff 遷移の種類> | オン/オフ遷移の種類のいずれかを指定します。 ブート、 faststartup、 Shutdown、 RebootCycle、 Standby、または休止状態です。 |
| -onoffresultspath <トレース ファイルが保存されるパス> | トレース ファイルの保存パスを指定します。 |
| -onoffproblemdescription <シナリオの説明> | シナリオの説明を指定します。 |
| -numiterations <OnOff トレース の反復回数> | マイク記録の反復回数を設定します。 既定では、組み込みまたはカスタムプロファイルファイルの設定で使用されます。 |
例
wpr -start CPU (Starts verbose CPU profile in memory mode)
wpr -start CPU.light -filemode (Starts light CPU profile in file mode)
wpr -start filename.wprp!ProfileName.Verbose (Starts verbose ProfileName profile defined in filename.wprp)
Stop
Stopオプションは、現在の記録を停止し、引数で指定されたファイルに保存します。
構文
wpr -stop <file> <problem description> -[skipPdbGen] [-force] [-compress]
次の表では、このオプションに適用できる引数について説明します。
| 引数 | 説明 |
|---|---|
| <ファイル名> | WPR が記録を保存するイベントトレースログ (ETL) ファイルを指定します。 この引数は必須です。 |
| <問題の説明> | 問題の説明を指定します。 この引数はオプションですが、使用することをお勧めします。 |
| -skipPdbGen | ngen の動的生成と .NET モジュールの埋め込み pdb を無効にします。 このオプションを使用すると、操作の停止時間を短縮できます。 |
| -force | ターゲット ファイル拡張子が .etl でない場合に警告を無効にします。 |
| -compress | 出力トレース ファイルを圧縮します。 |
マージする
Merge オプションは、etl ファイルを特定のファイルにマージします。
構文
wpr -merge <trace files ...> <merged file> -[skipPdbGen] [-compress] [-supresspii] [-mergeonly] [-injectonly]
次の表では、このオプションに適用できる引数について説明します。
| 引数 | 説明 |
|---|---|
| <トレース ファイル ...> | 1 つ以上のマージされていないイベント トレース ログ (ETL) ファイルを指定します。 この引数は必須です。 |
| <マージされたファイル> | WPR が ETL ファイルをマージする出力ファイルを指定します。 |
| -skipPdbGen | ngen の動的生成と .NET モジュールの埋め込み pdb を無効にします。 このオプションを使用すると、操作の停止時間を短縮できます。 |
| -compress | 出力トレース ファイルを圧縮します。 |
| -supresspii | 個人を特定できる (PII) 情報を抑制します。 |
| -mergeonly | コンピューター固有の情報やイメージ ID イベントを追加せずにトレースをマージします。 -injectonly とは併用できません。 |
| -injectonly | マージされたファイル内の元のイベントをコピーせずに、マシン固有のイベントまたはイメージ ID イベントのみを生成します。 |
Cancel
Cancelオプションは、記録されたデータを保存せずに現在の記録をキャンセルします。 現在アクティブになっているインスタンスがない場合は、 Cancel オプションを指定するとエラーが返されます。
構文
wpr -cancel
このオプションは引数を受け取りません。
状態
Statusオプションは、現在のWPRの記録に関する状態情報を表示します。
構文
wpr -status [profiles] [collectors [-details]]
現在アクティブになっている記録がない場合は、WPR が記録されていないことを示すメッセージが表示されます。 記録が現在アクティブで、引数が使用されていない場合は、次のステータス情報が表示されます:
WPR recording is in progress...
Time since start : 00:04:27
Dropped event : 0
Logging mode : Memory
– Statusオプションと共に引数を指定すると、上記の情報がそのオプションに固有のデータと共に表示されます。 次の表では、このオプションに適用できる引数について説明します。
| 引数 | 説明とアウトプット例 |
|---|---|
| profiles | この引数は、現在の WPR 記録で使用されている各プロファイルの一覧を表示します。
例: 次のプロファイルセットを使用してシステムの利用状況を記録しています: |
| Collectors | コレクターの情報を一覧表示します。 バッファーが失われている場合は、それらのバッファーが一覧表示されます。
例: コレクターをアクティブに記録する: |
| 詳細 | 各コレクターの追加の詳細については、リストを参照してください。 |
Profiledetails
Profiledetailsオプションは、プロファイルまたはプロファイルのセットに関する詳細情報を表示します。 複数のプロファイルを指定するには、次の構文を使用します。 < profilen >は各プロファイルの名前を表します。
構文
wpr -profiledetails <profile1>+<profile2>+...+<profilen> [-filemode] -onoffscenario <OnOff Transition Type>
次の表では、このオプションに適用できる引数について説明します。
| Switch | 説明 |
|---|---|
| -filemode | 記録がファイル モードで行われることを指定します。 既定のモードは「memory」です。) |
| -onoffscenario <OnOff 遷移の種類> | オン/オフ遷移の種類のいずれかを指定します。 ブート、 faststartup、 Shutdown、 RebootCycle、 Standby、または休止状態です。 |
ExportProfile
Exportprofileオプションは、組み込みプロファイルを指定されたファイルにエクスポートします。 コマンドを使用して、 wpr -Profiles使用可能な組み込みプロファイルを列挙します。 複数のプロファイルを指定するには、次の構文を使用します。 <profilen> は各プロファイルの名前を表します。 プロファイルの名前付け規則は、で使用した場合とまったく同じですwpr -start 。 プロファイルはとして指定され<profile name>[.{light|verbose}]ます。
構文
wpr -exportprofile <profile1>+<profile2>+...+<profilen> <ExportedFileName.wprp> [-filemode]
この例では、"GeneralProfileVerboseFile.wprp" というファイルに "filemode verbose GeneralProfile profile" というプロファイルをエクスポートします。
例
wpr -exportprofile GeneralProfile d:\profiles\GeneralProfileVerboseFile.wprp -filemode
プロバイダー
プロバイダーオプションに関する詳細情報を表示します。 プロバイダーは、Windows Performance Recorder (WPR) にイベントを公開する Windows イベント トレーシング (ETW) コンポーネントです。 プロバイダーに関する情報を表示するには、次の構文を使用します。-providers は、インストールされている、既知のすべてのプロバイダー、および登録されているプロバイダーを示します。
構文
wpr -providers
このオプションは引数を受け取りません。
Boottrace
Boottraceオプションは、指定されたプロファイルのautologger/globallogger セッションのレジストリエントリを構成します。
構文
wpr -boottrace {-addboot [<filename.wprp>!]<profile> [-addboot <profile> ...] [-filemode] [-recordtempto <temp folder path>] | -stopboot <recording filename> <Problem description> | -cancelboot}
次の表では、このオプションに適用できる引数について説明します。
| 引数 | 説明 |
|---|---|
| -boottrace | 自動ロガーを設定するには、次の引数を指定します。 現在の WPR では、この引数は省略可能です。 |
| -addboot | 指定されたプロファイルの自動ロガーレジストリエントリを設定します。 コマンドは、 wpr -addboot コマンドと同じオプションを受け取り wpr -start ます。 このオプションでは、トレースはすぐには開始されないことに注意してください。 再起動後に、オペレーティングシステムによって自動ロガーが開始されます。 |
| -stopboot | addbootによって構成された自動ロガーを削除し、ブート記録を停止して、すべての記録を指定されたファイルにマージします。 このオプションは、自動ロガーセッションが実行されている場合 (つまり、再起動後) にのみトレースを保存することに注意してください。 それ以外の場合、このオプションを選択すると、autologgerの構成のみが削除されます。 |
| -cancelboot | addbootによって構成されたautologgerを削除し、WPR によって開始されるブート記録をキャンセルします。 |
CaptureStateOnDemand
CaptureStateOnDemandオプションは、現在の記録に構成されているプロバイダーの状態をキャプチャします。 イベントプロバイダーは、セッションの実行中に、プロファイルファイル内の capturestateondemand 用に構成されている必要があります。
構文
wpr-capturestateondemand
このEventProvider方法の例を次に示します:
<EventProvider Id="EventProvider_Microsoft-Windows-Win32k" Name="Microsoft-Windows-Win32k" NonPagedMemory="true" CaptureStateOnly="true">
<CaptureStateOnDemand Timeout="5">
<Keyword Value="0x0"/>
</CaptureStateOnDemand>
</EventProvider>
Marker
マーカーオプションは、現在のシステムログセッションで、指定されたテキストでイベントマーカーを起動します。
構文
wpr -marker <text> [-flush]
| 引数 | 説明 |
|---|---|
| -flush | ワーキング セットをフラッシュします。 -MarkerFlush と同じです。 |
MarkerFlush (廃止)
MarkerFlush オプションは、指定されたテキストでイベント マーカーを発生し、ワーキング セットをフラッシュします。 このコマンドは、現在の WPR では使用されていません。
構文
wpr -markerflush <text>
フラッシュ
[ フラッシュ] オプション は、WPR を介して開始されたファイルにログ 記録セッションをフラッシュします。
構文
wpr -flush
このオプションは引数を受け取りません。
HeapTracingConfig
HeapTracingConfig オプションは、特定のプロセスまたはストア アプリのヒープ トレースを有効または無効にします。
構文
wpr -HeapTracingConfig <process name> [<package full name> <package relative app ID>] [{enable|disable}]
Note
- {enable|disable } パラメーターを省略すると、プロセスまたはアプリの現在のヒープ トレース 構成が表示されます。 例:
wpr -HeapTracingConfig Heaptest.exe enable - このコマンドでは、トレースはすぐには開始されません。ヒープ トレースを取得する前に実行する必要があります。 詳細については 、「ヒープ分析の記録 」を参照してください。
- トレースが 実行された後は、プロセス のパフォーマンスに影響を与える可能性があるから、プロセスに対して HeapTracingConfig を常に無効にします。
Disablepagingexecutive
Disablepagingexecutiveオプションは、ドライバーとカーネル モードのシステム コードをディスクにページ移動できるかどうかを指定します。 このオプションを on に設定すると 、ページングが防止されます。 このオプションは、レジストリの DisablePagingExecutive の値 を設定します。
構文
wpr -disablepagingexecutive {on | off}
Note
Windows 7 を実行している 64 ビット システムでイベント スタックを正しくキャプチャするには、disablepagingexecutiveを [オン] に設定し、パフォーマンス記録を開始する前にシステムを再起動する必要があります。 Windows 7 を実行している 32 ビット システムと Windows 8 以上を実行しているすべてのシステムでは、disablepagingexecutiveを On に設定せずにパフォーマンス記録を操作できます。
ログ
[ ログ] オプションは、イベント ログにデバッグ ログを追加して構成します。
構文
wpr -log {enabled | disabled | remove}
次の表では、このオプションに適用できる引数について説明します。
| キーワード | 説明 |
|---|---|
| 有効 | イベント ログのデバックのログ記録を有効にします |
| disabled | イベント ログのデバックのログ記録を無効にします |
| remove | WPR デバッグ ログ プロバイダー マニフェストをシステムからアンインストールします |
Purgecache
Purgecache オプション は、マネージド シンボル キャッシュを消去します。
構文
wpr -purgecache
このオプションは引数を受け取りません。
Help
コマンド プロンプト ウィンドウにオンライン ヘルプを表示するには、このオプションを使用します。
構文
wpr -help [start | stop | status | profiles | providers | tracing | boottrace | heap | hardwarecounter | advanced]
次の表では、このオプションに適用できる引数について説明します。
| キーワード | 説明 |
|---|---|
| No キーワード | オプションの一覧と簡単な説明を表示します。 特定のオプションについてさらにヘルプを表示するには、 キーワードを使用します。 (例: wpr -help start)。 |
| start | –start コマンドライン因数について説明します。 詳細については、Start を参照してください。 |
| stop | -stop、 -merge、および -cancel コマンド ライン引数について説明します。 |
| status | -status コマンドライン引数について説明します。 詳細については、Status を参照してください。 |
| profiles | -profiles、-profiledetails、および -exportprofile コマンドライン引数について説明します。 |
| providers | -providerslコマンドラインの引数について説明します。 詳細については、「プロバイダー」を参照してください。 |
| tracing | -marker、-flush、および -capturestateondemand コマンドライン引数について説明します。 |
| boottrace | -addboot、-stopboot、および -cancelboot コマンドライン引数について説明します。 |
| heap | -heaptracingconfig、-snapshotconfig、-enableperiodicsnapshot、-disableperiodicsnapshot、および -singlesnapshot コマンドライン引数について説明します。 |
| hardwarecounter | -pmcsources、-pmcsessions、-setprofint、-profint、および -resetprofint コマンドライン引数について説明します。 |
| advanced | -purgecache、-log、-disablepagingexecutive、-instancename、-container コマンドライン引数について説明します。 |
SnapshotConfig
SnapshotConfig オプションを使用すると、特定のプロセスまたはプロセスの<スナップショット オプション> \ の 1 回または定期的なスナップショットをキャプチャする機能が有効または無効になります。 現時点では、ヒープのスナップショットを取得できます。
構文
wpr -SnapshotConfig <snapshot option> {-name <process name> | -pid <pid 1> [pid 2] ...} [{enable|disable}]
{enable|disable}パラメーターを省略すると、プロセスまたはアプリの現在のヒープ トレースでのスナップショット構成が表示されます。 (例-name オプションのみ).
この例では 、snapshotconfig コマンドと イメージ名を使用します:
wpr -snapshotconfig heap -name Win32Project1.exe //query snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe enable //enable snapshot config
wpr -snapshotconfig heap -name Win32Project1.exe disable //disable snapshot config
この例では 、snapshotconfig コマンドと PIDを使用します:
wpr -snapshotconfig heap -pid 8048 enable //enable snapshot config
Note
プロセスと OS アーキテクチャが一致しない場合 (たとえば、64 ビット オペレーティング システム上の win32 アプリ)、イメージ名オプションを使用します。
次の表では、このオプションに適用できる引数について説明します。
| Switch | 説明 |
|---|---|
| <snapshot option> | スナップショット オプションの種類のいずれかを指定します。 現在使用できるのはHeap手順だけです。 |
| -name | プロセスの名前を指定します。 このスイッチは -Pid スイッチでは使用 できません。 このスイッチを使用してスナップショットを有効にした場合、指定したプロセス名のすべての新しいインスタンスに構成が適用されます。 テストが完了したら、必ず無効にしてください。 |
| -pid | プロセス ID を指定します。このスイッチは、-name スイッチでは使用できません。 このスイッチを使用してスナップショットを有効にすると、プロセスの有効期間中、構成が直ちに適用されます。 |
SingleSnapshot
SingleSnapshotオプションは、指定されたプロセス ID の< スナップショットオプション>のオンデマンドスナップショットをトリガーします。
構文
wpr -SnapshotConfig <snapshot option> <pid 1> [pid 2] ... [up to pid 8]
Note
SingleSnapshotを呼び出す前に、スナップショット機能をプロセス id (または名前) に対して有効にする必要があります。
例: wpr -singlesnapshot heap <pid for foo.exe>
詳細については、SnapshotConfig コマンドを参照してください。
次の表では、このオプションに適用できる引数について説明します。
| Switch | 説明 |
|---|---|
| <snapshot option> | スナップショット オプションの種類のいずれかを指定します。 |
| <pid> | プロセス id を指定します。 |
EnablePeriodicSnapshot
EnablePeriodicSnapshotオプションは、指定された間隔で定期的なスナップショットをトリガーし、特定のプロセス id を指定します
構文
wpr -enableperiodicsnapshot <snapshot option> <interval (in seconds)> <pid 1> [pid 2] ... [up to pid 8]
Note
SingleSnapshotを呼び出す前に、スナップショット機能をプロセス id (または名前) に対して有効にする必要があります。
例: wpr -enableperiodicsnapshot heap 60 <pid for foo.exe>
詳細については、SnapshotConfig コマンドを参照してください。
次の表では、このオプションに適用できる引数について説明します。
| Switch | 説明 |
|---|---|
| <snapshot option> | スナップショット オプションの種類のいずれかを指定します。 |
| <interval> | 間隔を秒単位で指定します。 注意有効な最小間隔は5です。 |
| <pid> | プロセス id を指定します。 |
DisablePeriodicSnapshot
Disableperiodicsnapshotオプションでは、 enableperiodicsnapshotオプションによって指定されたすべてのプロセスの定期的なスナップショットが無効になります。
構文
wpr -disableperiodicsnapshot <snapshot option>
例
wpr -disableperiodicsnapshot heap
次の表では、このオプションに適用できる引数について説明します。
| Switch | 説明 |
|---|---|
| <snapshot option> | スナップショット オプションの種類のいずれかを指定します。 |
PMCSources
PMCSources オプションは、システム上の PMU (パフォーマンス モニタリング ユニット) イベントの一覧と、カウンター オーバーフローの既定の間隔値を照会します。 間隔はイベントの数です。
構文
wpr -pmcsources
Note
パフォーマンスモニターのユニットイベントは、CPU のパフォーマンスを測定し、ワークロードの CPU の特性を理解するために使用されます。 Arm/Intel リファレンス ドキュメントの PMU イベントのサブセットのみが Windows HAL に実装されています。 Intel CPU デバイスでのこのオプションの出力例を次に示します:
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -pmcsources
Id Name Interval Min Max
--------------------------------------------------------------
0 Timer 10000 1221 1000000
2 TotalIssues 698400 4096 2147483647
6 BranchInstructions 65536 4096 2147483647
10 CacheMisses 65536 4096 2147483647
11 BranchMispredictions 65536 4096 2147483647
19 TotalCycles 65536 4096 2147483647
25 UnhaltedCoreCycles 65536 4096 2147483647
26 InstructionRetired 65536 4096 2147483647
27 UnhaltedReferenceCycles 65536 4096 2147483647
28 LLCReference 65536 4096 2147483647
29 LLCMisses 65536 4096 2147483647
30 BranchInstructionRetired 65536 4096 2147483647
31 BranchMispredictsRetired 65536 4096 2147483647
32 LbrInserts 65536 4096 2147483647
PMCSessions
PMCSessions オプションは、ハードウェア カウンターを使用してセッションの一覧を照会します。 このオプションは、Windows 11以降でのみ使用できます。
構文
wpr -pmcsessions
ProfInt
ProfInt オプションは、プロファイリングの間隔をクエリします。
構文
wpr -profint
例
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -profint
Current Profile Interval = 10000 [1.0000ms]
SetProfInt
SetProfInt オプションは PMU イベントのサンプリング プロファイル間隔を設定します。 PMU イベント名を省略した場合、既定値は [Timer] です。
構文
wpr -setprofint [PMU event name] 1221...10000000
例
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint 100000
New Profile Interval = 100000 [10.0000ms]
C:\Program Files (x86)\Windows Kits\10\Windows Performance Toolkit>wpr -setprofint TotalIssues 1000000
New Profile Interval = 100000 [Counter: TotalIssues]
ResetProfInt
Resetprofintオプションを指定すると、プロファイル間隔が既定値にリセットされます。
構文
wpr -resetprofint [Profile Source Name]
[プロファイルソース名]が指定されていない場合は、すべてのプロファイルソースが既定値にリセットされることに注意してください。
インスタンス名
Instancenameオプションは、トレースインスタンスを一意に識別する名前を指定します。
このオプションは、ログセッションを操作する任意のコマンドに適用し、ユーザーが指定したログセッション名を割り当てることができます。 このオプションを省略した場合、WPR は既定のセッション名を設定します。
構文
wpr –{option <arguments>} -instancename <text>
Note
-instancenameは最後のパラメーターにする必要があります。 このオプションを使用してログセッションが開始された場合は、後続のすべてのコマンドで同じ instancename オプションを使用する必要があります。 次に例を示します。
C:\wpt>wpr -start cpu -instancename CpuSession
C:\wpt>wpr -status -instancename CpuSession
WPR recording is in progress...
...
Time since start : 00:00:05
Dropped event : 0
Logging mode : Memory
C:\wpt>wpr -stop cpu.etl -> omitting instancename option would not find CpuSession
There are no trace profiles running.
Error code: 0xc5583000
C:\wpt>wpr -stop cpu.etl -instancename CpuSession -> trace will be saved
解説
管理対象のアプリケーションがシステム上で実行されていたときにキャプチャされたトレースを保存するたびに、WPR は、トレースファイルの横にマネージシンボルを保存します。 この機能により、マネージアプリケーションのパフォーマンス分析が可能になります。
マネージシンボルの生成は、リソースおよび時間のかかる操作です。 WPR では、マネージシンボルの生成を高速化するために、マネージシンボルキャッシュが自動的に作成されます。 WPR では、管理シンボルが必要な場合、まずこのキャッシュをチェックし、使用可能で適切なシンボルを再生成する代わりに使用します。
既定のマネージシンボルキャッシュの場所は、C:\ProgramData\WindowsPerformanceRecorder\ NGenPdbs_Cache です。