通过

如何：使用命令行将探查器附加到 ASP.NET Web 应用程序中以收集并发数据

  • 项目

本主题介绍如何使用 Visual Studio 分析工具的命令行工具将探查器附加到 ASP.NET 应用程序中，并收集进程和线程并发数据。

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

提示

Web 应用程序仅支持 /start:concurrency,resourceonly 选项。 不支持通过使用 /start:concurrency 或 /start:concurrency,threadonly 选项收集线程活动和可视化数据。

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

然后将探查器附加到承载您的网站的 ASP.NET 辅助进程。 在将探查器附加到应用程序时，可以暂停和继续数据收集。 若要结束分析会话，不得再将探查器附加到应用程序，并且必须显式关闭探查器。 在大多数情况下，应在会话结束时清除分析环境变量。

附加探查器

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

  1. 在**“命令提示符”**窗口中，通过键入以下命令初始化分析环境变量：

    VSPerfClrEnv /globalsampleon [/samplelineoff]

    • /globalsampleon 允许收集并发数据。

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

  2. 重新启动计算机。

  3. 通过键入以下命令启动探查器：

    VSPerfCmd **/start:concurrency,ResourceOnly /output:**OutputFile [Options]

    • /start 选项对探查器进行初始化以收集资源争用数据。

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

    可以将下表中的任意选项与 /start 选项一起使用。

    选项

    说明

    /user:[Domain\]UserName

    指定要允许其访问探查器的帐户的可选域名和用户名。

    /crosssession

    允许分析其他登录会话中的进程。

    /wincounter:WinCounterPath

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

    /automark:Interval

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

    /events:Config

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

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

  5. 通过键入以下命令将探查器附加到 ASP.NET 辅助进程：**VSPerfCmd /attach:PID [/targetclr:**Version]

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

    • /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 (PID) 或进程名称 (ProcName) 所指定的进程的数据。 /detach 停止对指定进程的数据收集，如果未指定任何进程，则停止对所有进程的数据收集。

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

结束分析会话

若要结束分析会话，探查器不得正在收集数据。 通过重新启动 ASP.NET 辅助进程或调用 VSPerfCmd /detach 选项，可以停止从用并发方法进行分析的应用程序中收集数据。 然后，可以调用 VSPerfCmd /shutdown 选项关闭探查器并关闭分析数据文件。 VSPerfClrEnv /globaloff 命令清除分析环境变量，但只有重新启动计算机之后才会重置系统配置。

结束分析会话

  1. 通过关闭探查器或在命令提示符下键入下面的命令，可从目标应用程序中分离探查器：

    VSPerfCmd /detach

  2. 通过在命令提示符下键入下面的命令关闭探查器：

    VSPerfCmd /shutdown

  3. （可选）按以下步骤清除分析环境变量：

    1. 在命令提示符下键入以下命令：

      VSPerfCmd /globaloff

    2. 重新启动计算机。

请参见

概念

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

其他资源

使用 VSPerfASPNETCmd 进行快速网站分析