如何：将探查器附加到 .NET Framework 独立应用程序，以便使用命令行收集并发数据
本主题介绍如何使用 Visual Studio 分析工具命令行工具将探查器附加到正在运行的 .NET Framework 独立（客户端）应用程序，以及如何收集进程和线程并发数据。
备注
分析工具的命令行工具位于 Visual Studio 安装目录的 \Team Tools\Performance Tools 子目录中。在 64 位计算机上，同时提供这些工具的 64 位和 32 位版本。若要使用探查器命令行工具，必须将该工具路径添加到命令提示符窗口的 PATH 环境变量或添加到命令本身。有关更多信息，请参见指定分析工具命令行工具的路径。
在将探查器附加到应用程序时，可以暂停和继续数据收集。 若要结束分析会话，必须从应用程序分离探查器并显式关闭探查器。
附加探查器
将探查器附加到正在运行的 .NET Framework 应用程序
打开命令提示符窗口。
启动探查器。 键入：
VSPerfCmd /start:concurrency **/output:**OutputFile[Options]
/output**:**OutputFile 选项对于 /start 是必需的。 OutputFile 指定分析数据 (.vsp) 文件的名称和位置。
可以将下列任意选项与 /start:concurrency 选项一起使用。
选项
说明
/wincounter:WinCounterPath
指定要在分析过程中收集的 Windows 性能计数器。
/automark:Interval
仅与 /wincounter 一起使用。 指定 Windows 性能计数器收集事件之间间隔的毫秒数。 默认值为 500 毫秒。
/events:Config
指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。 将在单独的 (.etl) 文件中收集 ETW 事件。
通过典型方式启动目标应用程序。
将探查器附加到目标应用程序。 键入：
VSPerfCmd /attach:PID [/lineoff] [**/targetclr:**Version]
PID 指定目标应用程序的进程 ID。 可以在 Windows 任务管理器中查看所有正在运行的进程的进程 ID。
/lineoff 禁用行号数据的收集。
/targetclr**:**Version 指定在应用程序中加载了多个版本的公共语言运行时 (CLR) 时要分析的运行时的版本。 可选。
控制数据收集
在目标应用程序运行期间，通过使用 VSPerfCmd.exe 选项开始和停止向文件写入数据，可以控制数据收集。 通过控制数据收集，可以收集程序执行的特定阶段（如启动或关闭应用程序）的数据。
开始和停止数据收集
以下 VSPerfCmd.exe 选项对可开始和停止数据收集。 在单独的命令行上指定每个选项。 您可以多次打开和关闭数据收集。
选项
说明
开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
/processon:PID /processoff:PID
开始 (/processon) 或停止 (/processoff) 进程 ID (PID) 所指定的进程的数据收集。
/attach 开始对由进程 ID (PID) 或进程名称 (ProcName) 指定的进程进行数据收集。 /detach 停止对指定进程的数据收集，如果未指定具体进程，则停止对所有进程的数据收集。
还可以使用 VSPerfCmd.exe /mark 选项在数据文件中插入分析标记。 /mark 命令添加一个标识符、一个时间戳和一个可选的用户定义的文本字符串。 标记可用于筛选探查器报告和数据视图中的数据。
结束分析会话
探查器未在收集数据时，才能结束分析会话。 通过关闭应用程序或调用 VSPerfCmd /detach 选项，可以停止从使用并发方法分析的应用程序中收集数据。 然后，可以调用 VSPerfCmd /shutdown 选项关闭探查器并关闭分析数据文件。 VSPerfClrEnv /off 命令清除分析环境变量。
结束分析会话
执行以下操作之一从目标应用程序分离探查器。
键入 VSPerfCmd /detach
- 或 -
关闭目标应用程序。
关闭探查器。 键入：
VSPerfCmd/shutdown
修订记录
日期 |
修订记录 |
原因 |
|---|---|---|
2011年十二月 |
已移除的 VSPerfClrEnv /sampleon 步骤。 |
内容 Bug 修复。 |