SPTAggregate は、サンプル プロファイル誘導最適化 (SPGO) のコマンドライン ツールです。 これを使用して、収集 xperf 1 つ以上の ETL (イベント トレース ログ) ファイルを 1 つの SPT (サンプル プロファイル トレース) ファイルに結合します。 必要に応じて、プロセス名またはバイナリ名でデータをフィルター処理し、カーネル イベントを除外できます。 SPT ファイルを作成したら、 SPDConvert を使用して、最適化ワークフロー用の SPD (サンプル プロファイル データベース) ファイルにインポートします。
ETL (イベント トレース ログ) ファイルには、xperf が記録する生のハードウェア パフォーマンス イベントが含まれています。
SPTAggregate は、これらの ETL ファイルを SPT 形式に変換します。この形式では、インポート用のサンプル イベントが SPDConvert によって SPD (サンプル プロファイル データベース) ファイルにパッケージ化されます。
Syntax
SPTAggregate[オプション] /etletlfilessptfile
パラメーター
options
SPTAggregateするには、次のオプションを指定します。
-
/process:<プロセス> プロセス名でイベントをフィルター処理します。 1 つ以上のプロセス名をコンマ区切りリストとして指定します。
例：/process:myapp.exe -
/binary:<>バイナリ名でイベントをフィルター処理します。 コンマ区切りリストとして 1 つ以上のバイナリ名を指定します。
例：/binary:mylib.dll,myapp.exe - /nokernel OS カーネル イベントを除外します。
- /ヘルプ ヘルプ情報を表示します。
etlfiles
処理する ETL (イベント トレース ログ) ファイルのコンマ区切りの一覧。
xperfを使用して ETL ファイルを収集します。
sptfile
作成する出力SPTファイル。
注釈
Note
このツールは、Visual Studio開発者コマンド プロンプトから実行します。
SPTAggregateを使用して、xperfによって収集された 1 つ以上の ETL ファイルを SPT ファイルに変換します。
/etl フラグは必須であり、ETL ファイルの一覧の前に置く必要があります。
SPDConvertを使用して、結果の SPT ファイルを SPD ファイルにインポートできます。
SPTAggregateはxperfを使用します。これには、xperfのパスが通っており、perfcore.ini の構成で説明されているperfcore.ini変更が適用されている必要があります。
SPTAggregate
xperf実行すると、次のようなパラメーターが使用されます。xperf -a spt -genSPT outputfile.spt -binary application.exe,support.dll,companion.dll-a sptはサンプル プロファイル トレース分析レポートの生成を指定し、-genSPTは出力 SPT ファイルを指定し、-binaryは指定されたバイナリに焦点を当てます。
xperf フラグの詳細については、Xperf Command-Line リファレンス ドキュメントを参照してください。
Example
この例では、1 つの ETL ファイルを SPT ファイルに変換します。
SPTAggregate /etl filename.etl filename.spt
この例では、イベントを特定のプロセスにフィルター処理します。
SPTAggregate /process:filename.exe /etl filename.etl filename.spt
この例では、2 つの ETL ファイルを集計し、カーネル イベントを除外します。
SPTAggregate /nokernel /etl run1.etl,run2.etl filename.spt
こちらも参照ください
チュートリアル: サンプル プロファイル ガイド付き最適化 (SPGO) を使用してパフォーマンスを改善する
プロファイルに基づく最適化
SPDConvert
SPDDump
SPTDump