如何：从命令行使用探查器检测独立 .NET Framework 组件并收集内存数据

本主题介绍如何使用 Visual Studio 分析工具命令行工具检测独立应用程序的 .NET Framework 组件（如 .exe 或 .dll 文件）以及如何使用探查器收集内存信息。

说明
分析工具的命令行工具位于 Visual Studio 安装目录的 \Team Tools\Performance Tools 子目录中。在 64 位计算机上，64 位和 32 位版本的工具都可用。若要使用探查器命令行工具，必须将该工具路径添加到命令提示符窗口的 PATH 环境变量或添加到命令本身。有关更多信息，请参见指定分析工具命令行工具的路径。

若要使用检测方法收集 .NET Framework 组件的内存数据，可使用 VSInstr.exe 工具生成该组件的检测版本，并使用 VSPerfCLREnv.cmd 工具初始化分析环境变量。然后使用 VSPerfCmd.exe 工具启动探查器。

在执行检测组件时，会自动将内存数据收集到数据文件中。在分析会话过程中可以暂停和继续数据收集。

若要结束分析会话，可关闭目标应用程序，然后显式关闭探查器。在大多数情况下，建议在会话结束时清除分析环境变量。

随探查器一起启动应用程序

选项	说明
/tracegc	只启用对内存分配数据的收集。
/tracegclife	启用对内存分配数据和对象生存期数据的收集。

启动探查器。键入：

**VSPerfCmd /start:trace /output:**OutputFile [Options]

可以将下列任意选项与 /start:trace 选项一起使用。

选项	说明
/user:[Domain\]UserName	指定拥有所分析进程的帐户的域名和用户名。仅当运行进程的用户不是已登录用户时，才需要此选项。进程所有者列在 Windows 任务管理器的“进程”选项卡上的“用户名”列中。
/crosssession	启用其他会话中的进程分析。如果应用程序在其他会话中运行，则需要此选项。会话标识符列在 Windows 任务管理器的“进程”选项卡上的“会话 ID”列中。/CS 可指定为 /crosssession 的缩略词。
/globaloff	若要启动探查器而暂停数据收集，请将 /globaloff 选项添加到 /start 命令行。使用 /globalon 可继续分析。
/wincounter:WinCounterPath	指定要在分析过程中收集的 Windows 性能计数器。
/automark:Interval	仅与 /wincounter 一起使用。指定 Windows 性能计数器收集事件之间间隔的毫秒数。默认值为 500 毫秒。
/counter:Config	从 Config 中所指定的处理器性能计数器收集信息。计数器信息将添加到在每个分析事件中收集的数据中。
events:Config	指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。将在单独的 (.etl) 文件中收集 ETW 事件。

在目标应用程序运行期间，通过使用 VSPerfCmd.exe 选项开始和停止向文件写入数据，可以控制数据收集。通过控制数据收集，可以收集程序执行的特定阶段（如启动或关闭应用程序）的数据。

以下 VSPerfCmd 选项对可开始和停止数据收集。在单独的命令行上指定每个选项。您可以多次打开和关闭数据收集。

选项	说明
/globalon /globaloff	开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
/processon:PID/processoff:PID	开始 (/processon) 或停止由进程 ID (PID) 指定的进程的 (/processoff) 数据收集。
/threadon:TID/threadoff:TID	开始 (/threadon) 或停止 (/threadoff) 线程 ID (TID) 所指定的线程的数据收集。

还可以使用 VSPerfCmd.exe/mark 选项在数据文件中插入分析标记。/mark 命令添加一个标识符、一个时间戳和一个可选的用户定义的文本字符串。标记可用于筛选数据。

若要结束分析会话，请关闭运行所检测的组件的应用程序，然后调用 VSPerfCmd /shutdown 选项关闭探查器，并关闭分析数据文件。VSPerfClrEnv /off 命令清除分析环境变量。