SPTAggregate

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