VSPerfReport
更新：2007 年 11 月
VSPerfReport 命令行工具用于使用 Visual Studio Team System Developer Edition 分析工具 分析数据文件创建报告。默认报告格式为 .csv 文件。
VSPerfReport 使用以下语法：
VSPerfReport [/U] vspfilename [/options]
注意：filename 必须是有效的 .vsp 或 .vsps 文件。
VSPerfReport 命令行工具也用于比较 .vsp 或 .vsps 文件。若要生成差异（“diff”）报告，请使用以下语法：
VSPerfReport [/U] /diff vspfilename1 vspfilename2 [/options]
vspfilename1 and vspfilename2 必须是有效的 .vsp 或 .vsps 文件。
常规报告选项
下表介绍了常规报告格式选项和用于选择要报告的数据的选项。
选项 |
说明 |
|---|---|
U |
报告输出和重定向控制台的输出写为 Unicode。必须是指定的第一个选项。 |
SUMMARY:[类型] |
创建一个或多个类型的报告。 ALL - 会生成所有报告类型。 CallerCallee - 报告包含函数之间的父/子关系。 Function- 报告包含调用的函数。 Module- 报告包含分析的模块。 CallTree- 报告包含调用的函数的层次结构。 Thread- 报告包含分析的线程。 Process - 报告包含分析的进程。 Type - 报告包含分配的字节数。 Header - 报告包含文件标头信息。 Mark - 报告包含所有标记。 Counter - 报告包含所有标记和计数器值。 Ip - 报告包含指令分析的数据。 Life - 报告包含分配对象的生存期（当已收集分配数据时可用）。 Line - 报告包含源代码行配置文件数据。 |
XML |
XML 格式的输出报告。 |
CALLTRACE |
创建函数进入和退出、ETW 事件和标记的列表。 |
CLEARPACKEDSYMBOLS |
从报告文件中移除以前打包的符号。 |
SYMBOLPATH:path |
符号的位置。 |
DEBUGSYMPATH |
调试从中搜索符号的位置。 |
PACKSYMBOLS |
在分析之后，将符号打包到报告文件中。 |
OUTPUT:路径|文件名 |
报告文件的位置。 |
SUMMARYFILEe |
分析并将分析后的信息保存在 .vsps 摘要文件中。 |
PRINTMARKS |
显示指定报告文件中所有标记的名称和时间戳。 |
PRINTMARKS |
报告包含所有标记的名称和时间戳。 |
? |
显示用法信息。 |
NOLOGO |
报告运行时隐藏版本信息。 |
筛选器选项
下表介绍用于筛选可用数据的选项。
选项 |
说明 |
|---|---|
STARTTIME:[值] |
仅显示值（以毫秒为单位）后收集的信息。 |
ENDTIME:[值] |
仅显示值（以毫秒为单位）前收集的信息。 |
MSFILTER:[开始时间,持续时间] |
仅显示从 STARTTIME 到持续时间（以毫秒为单位）长度的数据。 |
PROCESS:[pid] |
仅显示指定进程的数据。 |
THREAD:[threadid] |
仅显示指定线程的数据。 |
THREAD:[threadid,processid] |
仅显示与指定进程关联的指定线程的数据。 |
差异报告选项
下表介绍了用于比较报告文件的选项。
选项 |
说明 |
|---|---|
DIFF |
比较两个报告文件（.vsp 或 .vsps 文件）。使用 diff 选项时将忽略摘要选项。 |
DIFFTHRESHOLD:[值] |
在此阈值下，两个值之间的差异将被忽略。另外，具有此阈值下的值的新数据不会显示。 |
DIFFTABLE:[表名] |
使用此特定表比较文件。默认为函数表。 |
DIFFCOLUMN:[列名] |
使用此特定列比较值。默认为独占样本百分比列。 |
QUERYDIFFTABLES |
为提供的两个报告文件列出有效的表和列。 |