通过

如何：使用命令行通过探查器检测动态编译的 ASP.NET Web 应用程序并收集详细计时数据

  • 项目

本主题介绍如何使用 Visual Studio 分析工具命令行工具，以通过检测分析方法收集动态编译的 ASP.NET 应用程序的详细计时数据。

提示

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

若要从 ASP.NET Web 应用程序收集性能数据，请修改目标应用程序的 web.config 文件，以使 VSInstr.exe 工具可以检测动态编译的应用程序文件。 然后，使用 VSPerfCLREnv.cmd 工具在 Web 服务器上设置相应的环境变量以启用分析，然后重新启动计算机。

启动探查器，然后运行目标应用程序。 在将探查器附加到应用程序时，可以暂停和继续数据收集。 完成分析后，请依次关闭应用程序、Internet Information Services (IIS) 辅助进程和探查器。 完成分析工作后，请将 web.config 文件和 Web 服务器还原到其原始状态。

配置 ASP.NET Web 应用程序和 Web 服务器

配置 ASP.NET Web 应用程序和 Web 服务器

  1. 修改目标应用程序的 web.config 文件。 请参见如何：修改 Web.Config 文件以检测和分析动态编译的 ASP.NET Web 应用程序。

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

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

    VSPerfClrEnv /globaltraceon

    • /globaltraceon 使用检测方法启用分析。

  4. 重新启动计算机。

运行分析会话

分析 Web 应用程序

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

  2. 启动探查器。 键入：

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

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

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

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

    提示

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

    选项

    说明

    /user:[Domain\]UserName

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

    /crosssession

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

    /globaloff

    启动探查器，同时暂停数据收集。 使用 /globalon 可继续分析。

    /counter:Config

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

    /wincounter:WinCounterPath

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

    /automark:Interval

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

    /events:Config

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

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

控制数据收集

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

开始和停止数据收集

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

    选项

    说明

    /globalon /globaloff

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

    /processon:PID /processoff:PID

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

    /threadon:TID /threadoff:TID

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

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

结束分析会话

若要结束分析会话，请关闭目标 ASP.NET Web 应用程序，重置 IIS 以停止分析的进程，然后关闭探查器。

结束分析会话

  1. 关闭 ASP.NET Web 应用程序。

  2. 通过重置 Internet Information Services (IIS) 关闭 ASP.NET 工作进程。 键入：

    IISReset /stop

  3. 关闭探查器。 键入：

    VSPerfCmd /shutdown

  4. 重新启动 IIS。 键入：

    IISReset /start

还原应用程序和计算机配置

完成所有分析后，替换 web.config 文件，清除分析环境变量，然后重新启动计算机以将应用程序和服务器还原到分析前其所处的状态。

还原应用程序和计算机配置

  1. 将 web.config 文件替换为原始文件的副本。

  2. 清除分析环境变量。 键入：

    VSPerfCmd /globaloff

  3. 重新启动计算机。

请参见

概念

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

其他资源

探查器检测方法数据视图