SPTAggregate 是用于示例配置文件引导优化(SPGO)的命令行工具。 使用它可将由 xperf 收集的一个或多个 ETL(事件跟踪日志)文件合并为单个 SPT(示例分析跟踪)文件。 可以选择按进程或二进制名称筛选数据,并排除内核事件。 创建 SPT 文件后,使用 SPDConvert 将其导入 SPD (示例配置文件数据库)文件中,以便优化工作流。
ETL (事件跟踪日志)文件包含记录的原始硬件性能事件 xperf 。
SPTAggregate 将这些 ETL 文件转换为 SPT 格式;该格式会将示例事件打包,以便 SPDConvert 将其导入到 SPD(样本配置文件数据库)文件中。
Syntax
SPTAggregate[options] /etletlfilessptfile
参数
选项
向SPTAggregate指定以下选项:
-
/过程:<过程> 按进程名称筛选事件。 将一个或多个进程名称指定为逗号分隔的列表。
示例:/process:myapp.exe -
/二 进 制:<二 进 制 文件> 按二进制名称筛选事件。 将一个或多个二进制名称指定为逗号分隔的列表。
示例:/binary:mylib.dll,myapp.exe - /nokernel 排除 OS 内核事件。
- /帮助 显示帮助信息。
etlfiles
要处理的 ETL(事件跟踪日志)文件的逗号分隔列表。 使用 xperf 收集 ETL 文件。
sptfile
要创建的输出 SPT 文件。
注解
注释
从Visual Studio开发人员命令提示符运行此工具。
使用 SPTAggregate 将由 xperf 收集的一个或多个 ETL 文件转换为 SPT 文件。 标志 /etl 是必需的,并且必须位于 ETL 文件列表之前。 可以使用 SPDConvert 将生成的 SPT 文件导入到 SPD 文件中。
SPTAggregate 使用 xperf,它必须在你的 PATH 中,并按照 配置 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 Reference 文档。
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