如何:使用命令行将探查器附加到 .NET Framework 独立应用程序并收集应用程序统计信息
本主题介绍如何使用 Visual Studio 分析工具命令行工具将探查器附加到正在运行的 .NET Framework 独立(客户端)应用程序,以及如何使用采样方法收集性能统计信息。
说明 |
---|
Windows 8 和 Windows Server 2012 中的增强安全功能需要在 Visual Studio 探查器收集这些平台上的数据的方式上的重大更改。Windows 应用商店应用程序还需要新的集合技术。请参见 分析 Windows 8 和 Windows Server 2012 应用程序。 分析工具的命令行工具位于 Visual Studio 安装目录的 \Team Tools\Performance Tools 子目录中。在 64 位计算机上,64 位和 32 位版本的工具都可用。若要使用探查器命令行工具,必须将该工具路径添加到命令提示符窗口的 PATH 环境变量或添加到命令本身。有关详细信息,请参阅指定分析工具命令行工具的路径。 将层交互数据添加到运行的分析需要使用分析工具的特定程序。请参见 从命令行添加层交互数据。 |
若要收集 .NET Framework 应用程序的性能数据,必须先初始化相应的环境变量,然后再启动目标应用程序。在将探查器附加到应用程序时,可以暂停和继续数据收集。
若要结束分析会话,必须从应用程序分离探查器并显式关闭探查器。在大多数情况下,建议在分析会话结束时清除分析环境变量。
附加探查器
将探查器附加到正在运行的 .NET Framework 应用程序
打开命令提示符窗口。
初始化分析环境变量。键入:
VSPerfClrEnv /sampleon [/samplelineoff]
- /samplelineoff 选项禁用源代码行号数据的收集。
启动探查器。键入:
**VSPerfCmd /start:sample /output:**OutputFile [Options]
可将下列任意一个选项与 /start:sample 选项一起使用。
选项
描述
/user:[Domain\]UserName
指定拥有所分析进程的帐户的域名和用户名(可选)。仅当所分析的应用程序以登录用户之外的用户身份启动时,才需要此选项。
启用其他登录会话中的进程分析。/CS 可指定为 /crosssession 的缩略词。如果应用程序在其他会话中运行,则需要此选项。
/wincounter:WinCounterPath
指定要在分析过程中收集的 Windows 性能计数器。
/automark:Interval
仅与 /wincounter 一起使用。指定 Windows 性能计数器收集事件之间间隔的毫秒数。默认值为 500 毫秒。
/events:Config
指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。将在单独的 (.etl) 文件中收集 ETW 事件。
如有必要,通过典型方式启动目标应用程序。
将探查器附加到目标应用程序。键入:
VSPerfCmd /attach:{PID|ProcessName} [Sample Event] [**/targetclr:**Version]
PID 指定目标应用程序的进程 ID。ProcessName 指定进程的名称。请注意,如果指定 ProcessName,但有多个同名进程在运行,则结果是不可预知的。可以在 Windows 任务管理器中查看所有正在运行的进程的进程 ID。
/targetclr**:**Version 指定在应用程序中加载了多个版本的公共语言运行时 (CLR) 时要分析的运行时的版本。可选。
默认情况下,每经过 10,000,000 个非暂停处理器时钟周期,就对性能数据进行一次采样。这近似于对 1GHz 处理器每隔 10 秒采样一次。通过指定下列选项之一,可以更改时钟周期间隔或指定其他采样事件。/targetclr**:**Version 指定在应用程序中加载了多个版本的 CLR 时要分析的 CLR 版本。可选。
采样事件
描述
/timer:Interval
将采样间隔更改为 Interval 所指定的非暂停时钟周期数。
/pf [:Interval]
将采样事件更改为页面错误。如果指定了 Interval,则设置两次样本之间的页面错误数。默认值为 10。
/sys [:Interval]
将采样事件更改为进程对操作系统内核的系统调用 (syscall)。如果指定了 Interval,则设置两次样本之间的调用数。默认值为 10。
/counter:Config
将采样事件更改为处理器性能计数器,并将间隔更改为 Config 中指定的间隔。
控制数据收集
在目标应用程序运行期间,通过使用 VSPerfCmd.exe 选项开始和停止向探查器数据文件写入数据,可以控制数据收集。通过控制数据收集,可以收集程序执行的特定阶段(如启动或关闭应用程序)的数据。
开始和停止数据收集
以下选项对可开始和停止数据收集。在单独的命令行上指定每个选项。您可以多次打开和关闭数据收集。
选项
描述
开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
/processon:PID/processoff:PID
开始 (/processon) 或停止 (/processoff) PID 所指定的进程的数据收集。
/attach 开始对由 PID 或进程名称 (ProcName) 指定的进程进行数据收集。/detach 停止对指定进程的数据收集,如果未指定具体进程,则停止对所有进程的数据收集。
结束分析会话
若要结束分析会话,必须将探查器与所有被分析进程分离,并且必须显式关闭探查器。通过关闭应用程序或调用 VSPerfCmd /detach 选项,可以从使用采样方法分析的应用程序分离探查器。然后,可以调用 VSPerfCmd /shutdown 选项,关闭探查器和分析数据文件。VSPerfClrEnv /off 命令清除分析环境变量。
结束分析会话
执行以下操作之一从目标应用程序分离探查器:
键入 VSPerfCmd /detach
- 或 -
关闭目标应用程序。
关闭探查器。键入:
VSPerfCmd /shutdown
(可选)清除分析环境变量。键入:
VSPerfClrEnv /off