SPTAggregate 是用於取樣式設定檔導引最佳化(SPGO)的命令列工具。 使用它可將 xperf 收集的一個或多個 ETL(事件追蹤記錄)檔案合併為單一 SPT(樣本分析追蹤)檔案。 你可以選擇以程序名稱或二進位名稱過濾資料,並排除核心事件。 建立 SPT 檔案後,使用 SPDConvert 匯入 SPD(範例資料資料庫)檔案以優化工作流程。
ETL(事件追蹤記錄)檔案包含由 xperf 記錄的原始硬體效能事件。
SPTAggregate 將這些 ETL 檔案轉換成 SPT 格式,將範例事件打包,由 SPDConvert 匯入 SPD(範例設定資料庫)檔案。
Syntax
SPTAggregate[選項] /etletlfilessptfile
參數
選項
請向 SPTAggregate 指定以下選項:
-
/流程:<流程> 依程序名稱篩選事件。 請以逗號分隔的清單指定一個或多個程序名稱。
範例:/process:myapp.exe -
/二進位:<二進位> 以二進位名稱篩選事件。 請指定一個或多個二進位名稱為逗號分隔的清單。
範例:/binary:mylib.dll,myapp.exe - /nokernel 排除作業系統核心事件。
- /help 顯示說明資訊。
etlfiles
要處理的 ETL(事件追蹤記錄檔)檔案清單,以逗號分隔。 使用 xperf 收集 ETL 檔案。
SPTFILE
要建立的輸出 SPT 檔案。
備註
備註
從 Visual Studio 開發者指令提示字元執行此工具。
使用 SPTAggregate 將由 xperf 收集的一或多個 ETL 檔案轉換為 SPT 檔案。
/etl該旗標必須出現在 ETL 檔案清單之前。 你可以透過使用 SPDConvert將產生的 SPT 檔案匯入 SPD 檔案。
SPTAggregate 使用 xperf,其必須位於您的路徑中,並依照 Configure perfcore.ini 中所述完成 perfcore.ini 變更設定。
當執行時SPTAggregate,會使用如下參數:xperf其中 xperf -a spt -genSPT outputfile.spt -binary application.exe,support.dll,companion.dll 指定 產生樣本剖面追蹤分析報告、-a spt指定輸出 SPT 檔案,並將-genSPT分析聚焦於指定的二進位-binary檔。
如需更多有關 xperf 旗標的資訊,請參閱 Xperf 命令列參考文件。
Example
此範例將單一 ETL 檔案轉換為 SPT 檔案:
SPTAggregate /etl filename.etl filename.spt
此範例將事件過濾至特定程序:
SPTAggregate /process:filename.exe /etl filename.etl filename.spt
此範例彙整兩個 ETL 檔案,並排除核心事件:
SPTAggregate /nokernel /etl run1.etl,run2.etl filename.spt
另請參閱
教學:使用範例設定檔引導最佳化(SPGO)來提升效能
剖析導向最佳化
SPDConvert
SPDDump
SPTDump