如何：使用命令行将探查器附加到 .NET 服务以收集应用程序统计信息

  • 项目

本主题介绍如何使用 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 服务收集性能数据，必须使用 VSPerfCLREnv.cmd 工具初始化相应的环境变量。然后，必须重新启动承载该服务的计算机，并配置该计算机进行分析。然后将探查器附加到服务进程。在将探查器附加到服务时，可以暂停和继续数据收集。

若要结束分析会话，必须将探查器与服务断开，且显式关闭探查器。在大多数情况下，建议在会话结束时清除分析环境变量。

附加探查器

将探查器附加到 .NET Framework 服务

  1. 安装服务。

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

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

    VSPerfClrEnv /globalsampleon [/samplelineoff]

    • /globalsampleon 启用采样。

    • /samplelineoff 禁用将收集的数据分配到特定源代码行。指定此选项时，数据只分配给函数。

  4. 重新启动计算机。

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

  6. 启动探查器。键入：

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

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

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

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

    说明说明

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

    选项

    描述

    /user:[Domain\]UserName

    指定拥有所分析进程的帐户的域名和用户名。仅当运行进程的用户不是已登录用户时，才需要此选项。进程所有者列在 Windows 任务管理器的“进程”选项卡上的“用户名”列中。

    /crosssession

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

    /wincounter:WinCounterPath

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

    /automark:Interval

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

    /events:Config

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

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

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

    VSPerfCmd /attach: {PID|ProcName} [Sample Event] [/targetclr**:**Version]

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

    默认情况下，每经过 10,000,000 个非暂停处理器时钟周期，就对性能数据进行一次采样。这近似于每秒对 1GHz 处理器采样 100 次。通过指定下列选项之一，可以更改时钟周期间隔或指定其他采样事件。

    采样事件

    描述

    /timer:Interval

    将采样间隔更改为 Interval 所指定的非暂停时钟周期数。

    /pf[:Interval]

    将采样事件更改为页面错误。如果指定了 Interval，则设置两次样本之间的页面错误数。默认值为 10。

    /sys[:Interval]

    将采样事件更改为进程对操作系统内核的系统调用 (syscall)。如果指定了 Interval，则设置两次样本之间的调用数。默认值为 10。

    /counter:Config

    将采样事件更改为处理器性能计数器，并将间隔更改为 Config 中指定的间隔。
    • **targetclr:**Version 指定在应用程序中加载了多个版本的公共语言运行时 (CLR) 时要分析的运行时的版本。可选。

控制数据收集

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

开始和停止数据收集

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

    选项

    描述

    /globalon /globaloff

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

    /processon:PID/processoff:PID

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

    /attach:{PID|ProcName} /detach[:{PID|ProcName}]

    /attach 开始对由进程 ID 或进程名称指定的进程收集数据。/detach 停止对指定进程的数据收集，如果未指定具体进程，则停止对所有进程的数据收集。

结束分析会话

若要结束分析会话，必须从应用程序断开探查器并显式关闭探查器。通过关闭应用程序或调用 VSPerfCmd /detach 选项，可以从使用采样方法分析的应用程序分离探查器。然后，可以调用 VSPerfCmd /shutdown 选项，关闭探查器和分析数据文件。

VSPerfClrEnv /globaloff 命令清除分析环境变量，但只有重新启动计算机之后才会重置系统配置。

结束分析会话

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

    • 停止服务。

      - 或 -

    • 键入 VSPerfCmd /detach

  2. 关闭探查器。键入：

    VSPerfCmd /shutdown

  3. （可选）清除分析环境变量。键入：

    VSPerfClrEnv /globaloff

  4. 重新启动计算机。

请参见

概念

服务的命令行分析

其他资源

探查器采样方法数据视图