通过

如何：使用探查器命令行检测 .NET Framework 服务和收集内存数据

  • 项目

本主题介绍如何使用 Visual Studio 分析工具命令行工具检测 .NET Framework 服务和收集内存使用情况数据。 可以收集内存分配数据，也可以同时收集内存分配数据和对象生存期数据。

提示

如果计算机启动后无法重新启动某项服务（如操作系统启动时所启动的服务），则无法用检测方法分析该服务。

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

开始分析会话

若要从 .NET Framework 服务收集性能数据，请使用 VSPerfCLREnv.cmd 工具初始化相应的环境变量，并使用 VSInstr.exe 工具创建服务二进制文件的受检测副本。

承载该服务的计算机必须重新启动才能配置该服务进行分析。 还必须手动从服务控制管理器启动该服务。 然后启动探查器，再启动 .NET Framework 服务。

执行受检测组件后，会自动将内存数据收集到数据文件中。 在分析会话过程中可以暂停和继续数据收集。

若要结束分析会话，请关闭服务，然后显式关闭探查器。 在大多数情况下，建议在会话结束时清除分析环境变量。

开始分析 .NET Framework 服务

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

  2. 使用 VSInstr 工具生成服务二进制文件的受检测版本。

  3. 使用服务控制管理器将原始二进制文件替换为受检测版本。 确保将服务的“启动类型”设置为“手动”。

  4. 初始化分析环境变量。 键入：

    VSPerfClrEnv {/globaltracegc |/globaltracegclife}

    • /globaltracegc 和 /globaltracegclife 启用内存分配数据和对象生存期数据的收集。

      选项

      说明

      /globaltracegc

      仅收集内存分配数据。

      /globaltracegclife

      收集内存分配数据和对象生存期数据。

  5. 重新启动计算机。

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

  7. 启动探查器。 键入：

    VSPerfCmd /start:trace /output**:**OutputFile [Options]

    • /start: contention 选项初始化探查器。

    • **/output:**OutputFile 选项对于 /start 是必需的。 OutputFile 指定分析数据 (.vsp) 文件的名称和位置。

    可以将下列任意选项与 /start:sample 选项一起使用。

    提示

    服务通常需要 /user 和 /crosssession 选项。

    选项

    说明

    /user:[Domain\]UserName

    指定拥有 ASP.NET 工作进程的帐户的域名和用户名。 如果该进程以已登录用户之外的用户身份运行，则需要此选项。 进程所有者列在 Windows 任务管理器的“进程”选项卡上的“用户名”列中。

    /crosssession

    允许分析其他登录会话中的进程。 如果 ASP.NET 应用程序在其他会话中运行，则需要此选项。 会话 ID 列在 Windows 任务管理器“进程”选项卡上的“会话 ID”列中。 /CS 可指定为 /crosssession 的缩略词。

    /waitstart[:Interval]

    指定探查器初始化期间在返回错误之前等待的秒数。 如果未指定 Interval，则探查器将无限期等待。 默认情况下，/start 将立即返回。

    /globaloff

    若要启动探查器而暂停数据收集，请将 /globaloff 选项添加到 /start 命令行。 使用 /globalon 可继续分析。

    /counter:Config

    从 Config 中所指定的处理器性能计数器收集信息。 计数器信息将添加到在每个分析事件中收集的数据中。

    /wincounter:WinCounterPath

    指定要在分析过程中收集的 Windows 性能计数器。

    /automark:Interval

    仅与 /wincounter 一起使用。 指定 Windows 性能计数器收集事件之间间隔的毫秒数。 默认值为 500 毫秒。

    /events:Config

    指定要在分析过程中收集的 Windows 事件跟踪 (ETW) 事件。 将在单独的 (.etl) 文件中收集 ETW 事件。

  8. 如有必要，请启动相应服务。

  9. 将探查器附加到该服务。 键入：

    **VSPerfCmd /attach:**PID|ProcessName

    • 指定服务的进程 ID 或进程名称。 可以在 Windows 任务管理器中查看所有正在运行的进程的进程 ID 和名称。

控制数据收集

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

开始和停止数据收集

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

    选项

    说明

    /globalon /globaloff

    开始 (/globalon) 或停止 (/globaloff) 所有进程的数据收集。

    /processon:PID/processoff:PID

    开始 (/processon) 或停止 (/processoff) 进程 ID (PID) 所指定的进程的数据收集。

    /threadon:TID/threadoff:TID

    开始 (/threadon) 或停止 (/threadoff) 线程 ID (TID) 所指定的线程的数据收集。

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

结束分析会话

若要结束分析会话，请关闭正在运行受检测组件的应用程序，然后启动 VSPerfCmd /shutdown 选项来关闭探查器和关闭分析数据文件。 VSPerfClrEnv /globaloff 命令清除分析环境变量。

结束分析会话

  1. 从服务控制管理器中停止相应服务。

  2. 关闭探查器。 键入：

    VSPerfCmd /shutdown

  3. 完成所有分析后，清除分析环境变量。 键入：

    VSPerfClrEnv /globaloff

    将受检测模块替换为原始模块。 如有必要，重新配置服务的“启动类型”。

  4. 重新启动计算机。

请参见

概念

服务的命令行分析

其他资源

分析工具 .NET 内存数据视图