如何：将探查器附加到 .NET Framework 独立应用程序，以便使用命令行收集并发数据

本主题介绍如何使用 Visual Studio 分析工具命令行工具将探查器附加到正在运行的 .NET Framework 独立（客户端）应用程序，以及如何收集进程和线程并发数据。

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

在将探查器附加到应用程序时，可以暂停和继续数据收集。若要结束分析会话，必须从应用程序分离探查器并显式关闭探查器。

附加探查器

将探查器附加到正在运行的 .NET Framework 应用程序

1. 打开命令提示符窗口。

2. 启动探查器。键入：

   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 事件。

3. 通过典型方式启动目标应用程序。

4. 将探查器附加到目标应用程序。键入：

   VSPerfCmd /attach:PID [/lineoff] [**/targetclr:**Version]

   • PID 指定目标应用程序的进程 ID。可以在 Windows 任务管理器中查看所有正在运行的进程的进程 ID。

   • /lineoff 禁用行号数据的收集。

   • /targetclr**:**Version 指定在应用程序中加载了多个版本的公共语言运行时 (CLR) 时要分析的运行时的版本。可选。

控制数据收集

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

开始和停止数据收集

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

  选项	说明
  /globalon /globaloff	开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
  /processon:PID/processoff:PID	开始 (/processon) 或停止 (/processoff) 进程 ID (PID) 所指定的进程的数据收集。
  /attach:{PID|ProcName} /detach[:{PID|ProcName}]	/attach 开始对由进程 ID (PID) 或进程名称 (ProcName) 指定的进程进行数据收集。/detach 停止对指定进程的数据收集，如果未指定具体进程，则停止对所有进程的数据收集。

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

结束分析会话

探查器未在收集数据时，才能结束分析会话。通过关闭应用程序或调用 VSPerfCmd /detach 选项，可以停止从使用并发方法分析的应用程序中收集数据。然后，可以调用 VSPerfCmd /shutdown 选项关闭探查器并关闭分析数据文件。VSPerfClrEnv /off 命令清除分析环境变量。

结束分析会话

1. 执行以下操作之一从目标应用程序分离探查器。

   • 键入 VSPerfCmd /detach

     - 或 -

   • 关闭目标应用程序。

2. 关闭探查器。键入：

   VSPerfCmd/shutdown

修订记录