如何:使用命令行将探查器附加到 ASP.NET Web 应用程序中以收集应用程序统计信息

本主题介绍如何使用 Visual Studio 分析工具命令行工具将探查器附加到 ASP.NET Web 应用程序,以及如何使用采样方法收集性能统计信息。

提示

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

若要从 ASP.NET Web 应用程序中收集性能数据,必须初始化相应的环境变量并重新启动承载 ASP.NET 应用程序的计算机,才能配置 Web 服务器进行分析。

然后将探查器附加到承载您的网站的 ASP.NET 辅助进程。 在将探查器附加到应用程序时,可以暂停和继续数据收集。

若要结束分析会话,必须将探查器与被分析的应用程序分离,并且必须显式关闭探查器。 在大多数情况下,建议在会话结束时清除分析环境变量。

启动探查器并将其附加到 ASP.NET Web 应用程序

将探查器附加到 ASP.NET Web 应用程序

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

  2. 初始化分析环境变量。 键入:

    VSPerfClrEnv /globalsampleon [/samplelineoff]

    • /globalsampleon 启用采样。

    • /samplelineoff 禁止向源代码的特定行分配收集的数据。 指定此选项时,数据只分配给函数。

  3. 重新启动计算机。

  4. 启动探查器。 键入:VSPerfCmd /start:sample /output**:**OutputFile[Options]

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

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

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

    提示

    ASP.NET 应用程序通常需要 /user/crosssession 选项。

    选项

    说明

    /user:[Domain\]UserName

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

    /crosssession

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

    /wincounter:WinCounterPath

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

    /automark:Interval

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

    /events:Config

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

  5. 通过典型方式启动 ASP.NET Web 应用程序。

  6. 将探查器附加到 ASP.NET 辅助进程。 键入:VSPerfCmd /attach:{PID |ProcName} [Sample Event] [/targetclr**:**Version]

    • PID 指定 ASP.NET 辅助进程的进程 ID;ProcName 指定辅助进程的名称。 可以在 Windows 任务管理器中查看所有正在运行的进程的进程 ID 和名称。

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

    采样事件

    说明

    /timer:Interval

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

    /pf[:Interval]

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

    /sys[:Interval]

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

    /counter:Config

    将采样事件更改为处理器性能计数器,并将间隔更改为 Config 中指定的间隔。

    /targetclr:Version

    指定在应用程序中加载了多个版本的公共语言运行时 (CLR) 时要分析的运行时的版本。

    • **targetclr:**Version 用于在应用程序中加载了多个版本的 CLR 时指定要对哪一运行时版本进行分析。 可选。

控制数据收集

在应用程序运行期间,可以使用 VSPerfCmd.exe 选项开始和停止向文件写入数据,从而控制数据收集。 通过控制数据收集,可以收集程序执行的特定阶段(如启动或关闭应用程序阶段)的数据。

开始和停止数据收集

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

    选项

    说明

    /globalon /globaloff

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

    /processon:PID /processoff:PID

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

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

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

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

结束分析会话

若要结束分析会话,请关闭 ASP.NET Web 应用程序,然后使用 Internet Information Services (IIS) IISReset 命令关闭 ASP.NET 辅助进程。 调用 VSPerfCmd /shutdown 选项关闭探查器并关闭分析数据文件。

VSPerfClrEnv /globaloff 命令清除分析环境变量。 必须重新启动计算机,才能应用新的环境设置。

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

结束分析会话

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

    • 键入 VSPerfCmd /detach

      - 或 -

    • 关闭 ASP.NET 辅助进程。

  2. 关闭探查器。 键入:VSPerfCmd /shutdown

  3. (可选)清除分析环境变量。 键入:

    VSPerfCmd /globaloff

  4. 重新启动计算机。

请参见

概念

从命令行分析 ASP.NET Web 应用程序

其他资源

探查器采样方法数据视图