如何：使用命令行将探查器附加到本机独立应用程序并收集应用程序统计信息
本主题介绍如何使用 Visual Studio 分析工具命令行工具将探查器附加到某个正在运行的本机独立（客户端）应用程序，并使用采样方法收集性能统计信息。
提示
分析工具的命令行工具位于 Visual Studio 安装目录的 \Team Tools\Performance Tools 子目录中。 在 64 位计算机上，64 位和 32 位版本的工具都可用。 若要使用探查器命令行工具，必须将该工具路径添加到命令提示符窗口的 PATH 环境变量或添加到命令本身。 有关更多信息，请参见指定分析工具命令行工具的路径。
在将探查器附加到应用程序时，可以暂停和继续数据收集。 若要结束分析会话，必须从应用程序分离探查器并显式关闭探查器。
附加探查器
若要使用探查器将探查器附加到目标应用程序，应使用 VSPerfCmd /start 和 /attach 选项初始化探查器并将其附加到目标应用程序。 可以在单个命令行上指定 /start 和 /attach 及其各自的选项。 还可以添加 /globaloff 选项，以在目标应用程序启动时暂停数据收集。 然后，可以使用 /globalon 开始收集数据。
将探查器附加到正在运行的 .NET 应用程序
打开命令提示符窗口。
启动探查器。 键入：
**VSPerfCmd /start:sample /output:**OutputFile [Options]
/start:sample 选项初始化探查器。
/output**:**OutputFile 选项必须与 /start 一起使用。 OutputFile 指定分析数据 (.vsp) 文件的名称和位置。
可以将下列任意选项与 /start:sample 选项一起使用。
选项
说明
/user:[Domain\]UserName
指定拥有所分析进程的帐户的域名和用户名。 仅当运行进程的用户不是已登录用户时，才需要此选项。 进程所有者列在 Windows 任务管理器的“进程”选项卡上的“用户名”列中。
启用其他会话中的进程分析。 如果 ASP.NET 应用程序在其他会话中运行，则需要此选项。 会话标识符列在 Windows 任务管理器的“进程”选项卡上的“会话 ID”列中。 /CS 可指定为 /crosssession 的缩略词。
/wincounter:WinCounterPath
指定要在分析过程中收集的 Windows 性能计数器。
/automark:Interval
仅与 /wincounter 一起使用。 指定 Windows 性能计数器收集事件之间间隔的毫秒数。 默认值为 500 毫秒。
/events:Config
指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。 将在单独的 (.etl) 文件中收集 ETW 事件。
将探查器附加到目标应用程序。 键入：
VSPerfCmd /attach:{PID|ProcName} [Sample Event]
PID 指定目标应用程序的进程 ID。 ProcessName 指定进程的名称。 请注意，如果指定 ProcessName，但有多个同名进程在运行，则结果是不可预知的。 可以在 Windows 任务管理器中查看所有正在运行的进程的进程 ID。
默认情况下，每经过 10,000,000 个非暂停处理器时钟周期，就对性能数据进行一次采样。 这近似于在 1GH 处理器上每秒采样 100 次。 通过指定下列选项之一，可以更改时钟周期间隔或指定其他采样事件。
采样事件
说明
/timer:Interval
将采样间隔更改为 Interval 所指定的非暂停时钟周期数。
/pf[:Interval]
将采样事件更改为页面错误。 如果指定了 Interval，则设置两次样本之间的页面错误数。 默认值为 10。
/sys [:Interval]
将采样事件更改为进程对操作系统内核的系统调用 (syscall)。 如果指定了 Interval，则设置两次样本之间的调用数。 默认值为 10。
/counter:Config
将采样事件更改为处理器性能计数器，并将间隔更改为 Config 中指定的间隔。
控制数据收集
在目标应用程序运行时，可以使用 VSPerfCmd.exe 选项启动和停止向探查器数据文件写入数据。 通过控制数据收集，可以收集程序执行的特定阶段（如启动或关闭应用程序）的数据。
开始和停止数据收集
以下 VSPerfCmd 选项对可开始和停止数据收集。 在单独的命令行上指定每个选项。 您可以多次打开和关闭数据收集。
选项
说明
开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
/processon:PID /processoff:PID
开始 (/processon) 或停止 (/processoff) PID 所指定的进程的数据收集。
/attach 开始收集由 PID 指定的进程的数据。 /detach 停止对所有进程的数据收集。
还可以使用 VSPerfCmd.exe /mark 选项在数据文件中插入分析标记。 /mark 命令添加一个标识符、一个时间戳和一个可选的用户定义的文本字符串。 标记可用于筛选探查器报告和数据视图中的数据。
结束分析会话
若要结束分析会话，必须将探查器与所有被分析进程分离，并且必须显式关闭探查器。 通过关闭应用程序或调用 VSPerfCmd /detach 选项，可以从使用采样方法分析的应用程序分离探查器。 然后，可以调用 VSPerfCmd /shutdown 选项关闭探查器并关闭分析数据文件。 VSPerfClrEnv /off 命令清除分析环境变量。
结束分析会话
执行以下操作之一从目标应用程序分离探查器。
键入 VSPerfCmd /detach
- 或 -
关闭目标应用程序。
关闭探查器。 键入：
VSPerfCmd /shutdown
（可选）清除分析环境变量。 键入：
VSPerfClrEnv /off