如何:使用命令行将探查器附加到 .NET 服务,以收集并发数据
本主题介绍如何使用 Visual Studio 分析工具命令行工具将探查器附加到 .NET Framework 服务,以及如何使用采样方法收集进程和线程并发数据。
提示
分析工具的命令行工具位于 Visual Studio 安装目录的 \Team Tools\Performance Tools 子目录中。 在 64 位计算机上,同时提供这些工具的 64 位和 32 位版本。 若要使用探查器命令行工具,必须将该工具路径添加到命令提示符窗口的 PATH 环境变量或添加到命令本身。 有关更多信息,请参见指定分析工具命令行工具的路径。
若要收集 .NET Framework 服务的性能数据,必须初始化相应的环境变量,并且必须重新启动承载该服务的计算机,以便将它配置为进行分析。
然后将探查器附加到服务进程。 在将探查器附加到服务时,可以暂停和继续数据收集。 若要结束分析会话,必须将探查器与服务断开并且必须显式关闭探查器。 在大多数情况下,建议在会话结束时清除分析环境变量。
附加探查器
将探查器附加到 .NET Framework 服务
安装服务。
打开命令窗口。
初始化分析环境变量。 键入:
VSPerfClrEnv /globalsampleon [/samplelineoff]
/globalsampleon 启用采样。
/samplelineoff 禁用将收集的数据分配到特定源代码行。 指定此选项时,数据只分配给函数。
重新启动计算机。
启动探查器。 键入:
VSPerfCmd /start:concurrency[,{ResourceOnly|ThreadOnly}] **/output:**OutputFile [Options]
/start 选项初始化探查器。
/start:concurrency
允许同时收集资源争用和线程执行数据。
/start:concurrency,resourceonly
启用仅收集资源争用数据的操作。
/start:concurrency,threadonly
启用仅收集线程执行数据的操作。
/output**:**OutputFile 选项对于 /start 是必需的。 OutputFile 指定分析数据 (.vsp) 文件的名称和位置。
可以将下列任意选项与 /start 选项一起使用。
提示
服务通常需要 /user 和 /crosssession 选项。
选项
说明
/user:[Domain\]UserName
指定拥有所分析进程的帐户的域名和用户名。 仅当运行进程的用户不是已登录用户时,才需要此选项。 进程所有者列在 Windows 任务管理器的“进程”选项卡上的“用户名”列中。
启用对其他会话中进程的分析。 如果服务在其他会话中运行,则需要此选项。 会话 ID 列在 Windows 任务管理器的“进程”选项卡上的“会话 ID”列中。 /CS 可指定为 /crosssession 的缩略词。
/wincounter:WinCounterPath
指定要在分析过程中收集的 Windows 性能计数器。
/automark:Interval
仅与 /wincounter 一起使用。 指定 Windows 性能计数器收集事件之间间隔的毫秒数。 默认值为 500 毫秒。
/events:Config
指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。 将在单独的 (.etl) 文件中收集 ETW 事件。
如有必要,请启动相应服务。
将探查器附加到服务。 键入:
**VSPerfCmd /attach:PID [/targetclr:**Version]
PID 指定服务的进程 ID 或进程名称。 可以在 Windows 任务管理器中查看所有正在运行的进程的进程 ID。
**targetclr:**Version 指定在应用程序中加载了多个版本的公共语言运行时 (CLR) 时要分析的运行时的版本。 可选。
控制数据收集
在服务运行期间,通过使用 VSPerfCmd.exe 选项开始和停止向文件写入数据,可以控制数据收集。 通过控制数据收集,可以收集程序执行的特定阶段(如启动或关闭应用程序)的数据。
开始和停止数据收集
以下 VSPerfCmd 选项对可开始和停止数据收集。 在单独的命令行上指定每个选项。 您可以多次打开和关闭数据收集。
选项
说明
开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
/processon:PID /processoff:PID
开始 (/processon) 或停止 (/processoff) 进程 ID (PID) 所指定的进程的数据收集。
/attach:{PID|ProcName} /detach[:{PID|ProcName}]
/attach 开始对由进程 ID 或进程名称指定的进程收集数据。 /detach 停止对指定进程的数据收集,如果未指定具体进程,则停止对所有进程的数据收集。
还可以使用 VSPerfCmd.exe /mark 选项在数据文件中插入分析标记。 /mark 命令添加一个标识符、一个时间戳和一个可选的用户定义的文本字符串。 标记可用于筛选探查器报告和数据视图中的数据。 以下 VSPerfCmd 选项对可开始和停止数据收集。 在单独的命令行上指定每个选项。 您可以多次打开和关闭数据收集。
结束分析会话
探查器未在收集数据时,才能结束分析会话。 通过停止服务,或调用 VSPerfCmd /detach 选项,可以停止从使用并发方法分析的应用程序中收集数据。 然后,可以调用 VSPerfCmd /shutdown 选项关闭探查器并关闭分析数据文件。 VSPerfClrEnv /globaloff 命令清除分析环境变量,但只有重新启动计算机之后才会重置系统配置。
结束分析会话
执行以下操作之一从目标应用程序分离探查器。
停止服务。
- 或 -
键入 VSPerfCmd /detach.
关闭探查器。 键入:
VSPerfCmd Shutdown
可选。 清除分析环境变量。 键入:
VSPerfCmd /globaloff
然后重新启动计算机。