如何：使用探查器命令行检测 .NET 服务和收集详细计时数据
本主题介绍如何使用 Visual Studio 高级专业版分析工具的命令行工具检测 .NET Framework 服务和收集详细计时数据。
.gif "说明") 说明 |
|---|
如果一个服务在计算机启动之后无法重新启动，这样的服务只能在操作系统启动时启动，则无法使用检测方法分析该服务。 分析工具的命令行工具位于 Visual Studio 安装目录的 \Team Tools\Performance Tools 子目录中。在 64 位计算机上，同时提供这些工具的 64 位和 32 位版本。若要使用探查器命令行工具，必须将该工具路径添加到命令提示符窗口的 PATH 环境变量中，或添加到命令本身。有关详细信息，请参阅指定分析工具命令行工具的路径。 将层交互数据添加到运行的分析需要使用分析工具的特定程序。请参见 从命令行添加层交互数据。 |
若要使用检测方法从 .NET Framework 服务收集详细计时数据，请使用 VSInstr.exe 工具生成组件的受检测版本。然后，将该服务的非检测版本替换为检测版本，确保将该服务配置为手动启动。使用 VSPerfCLREnv.cmd 工具初始化全局分析环境变量并重新启动主机。然后启动探查器。
在启动该服务时，会自动将计时数据收集到数据文件中。在分析会话过程中可以暂停和继续数据收集。
若要结束分析会话，可关闭该服务，然后显式关闭探查器。在大多数情况下，建议在会话结束时清除分析环境变量。
将应用程序与探查器一起启动
开始分析 .NET Framework 服务
打开命令提示符窗口。
使用 VSInstr 工具生成该服务版本的检测版本。
使用检测版本替换原始版本。在 Windows 服务控制管理器中，确保将服务的“启动类型”设置为“手动”。
初始化 .NET Framework 分析环境变量。键入：
VSPerfClrEnv /globaltraceon
重新启动计算机。
打开命令提示符窗口。
启动探查器。键入：
**VSPerfCmd /start:trace /output:**OutputFile[Options]
可以将下列任意一个选项与 /start:trace 选项一起使用。
说明分析服务通常需要 /user 和 /crosssession 选项。
选项
描述
/user:[Domain\]UserName
指定拥有所分析进程的帐户的域名和用户名。仅当运行进程的用户不是已登录用户时，才需要此选项。进程所有者列在 Windows 任务管理器的“进程”选项卡上的“用户名”列中。
启用其他会话中的进程分析。如果应用程序在其他会话中运行，则需要此选项。会话 ID 列在 Windows 任务管理器的“进程”选项卡上的“会话 ID”列中。/CS 可指定为 /crosssession 的缩略词。
/waitstart[:Interval]
指定探查器初始化期间在返回错误之前等待的秒数。如果未指定 Interval，则探查器将无限期等待。默认情况下，/start 将立即返回。
若要启动探查器而暂停数据收集，请将 /globaloff 选项添加到 /start 命令行。使用 /globalon 可继续分析。
/counter:Config
从 Config 中所指定的处理器性能计数器收集信息。计数器信息将添加到在每个分析事件中收集的数据中。
/wincounter:WinCounterPath
指定要在分析过程中收集的 Windows 性能计数器。
/automark:Interval
仅与 /wincounter 一起使用。指定 Windows 性能计数器收集事件之间间隔的毫秒数。默认值为 500 毫秒。
/events:Config
指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。将在单独的 (.etl) 文件中收集 ETW 事件。
从 Windows 服务控制管理器中启动相应服务。
控制数据收集
在服务运行时，可以使用 VSPerfCmd.exe 选项启动和停止向探查器数据文件写入数据。通过控制数据收集，可以收集程序执行的特定阶段（如启动或关闭服务阶段）的数据。
开始和停止数据收集
以下 VSPerfCmd 选项对可开始和停止数据收集。在单独的命令行上指定每个选项。您可以多次打开和关闭数据收集。
选项
描述
开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。
/processon:PID/processoff:PID
开始 (/processon) 或停止 (/processoff) 进程 ID (PID) 所指定的进程的数据收集。
/threadon:TID/threadoff:TID
开始 (/threadon) 或停止 (/threadoff) 线程 ID (TID) 所指定的线程的数据收集。
结束分析会话
若要结束分析会话，请停止正在运行受检测组件的服务，然后调用 VSPerfCmd /shutdown 选项以关闭探查器和关闭分析数据文件。VSPerfClrEnv /globaloff 命令清除分析环境变量。
必须重新启动计算机，才能应用新的环境设置。
结束分析会话
从服务控制管理器停止服务。
关闭探查器。键入：
VSPerfCmd /shutdown
完成所有分析后，清除分析环境变量。键入：
VSPerfClrEnv /globaloff
使用检测模块替换原始模块。如有必要，重新配置服务的“启动类型”。
重新启动计算机。