通过

如何：使用命令行同时启用独立的 .NET Framework 应用程序和探查器，以收集并发数据

  • 项目

本主题介绍如何使用分析工具命令行工具的 Visual Studio 启动 .NET framework 独立 (客户端) 应用程序，以及收集进程和线程并发数据

备注

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

将探查器附加到应用程序时，可以暂停和继续数据收集。 若要结束分析会话，不得再将探查器附加到应用程序，并且必须显式关闭探查器。

使用探查器启动应用程序

若要生成的探查器的 .NET framework 目标应用程序，请使用 VSPerfClrEnv.exe 设置 .NET framework 分析变量。 然后使用 VSPerfCmd /start 和 /launch 选项初始化探查器并启动应用程序。 可以在单个命令行上指定 /start 和 /launch 及其各自的选项。 ，以便在目标应用程序启动时，还可以添加 /globaloff 命令行添加选项。到暂停数据收集。 然后使用在单独的命令行上的 /globalon 开始收集数据。

带探查器启动应用程序

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

  2. 启动探查器。 类型:

    VSPerfCmd /start:concurrency[,{ResourceOnly|ThreadOnly}] **/output:**OutputFile [Options]

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

      /start:concurrency

      收集资源争用和线程执行数据的操作。

      /start:concurrency,resourceonly

      仅收集资源争用数据的操作。

      /start:concurrency,threadonly

      仅收集线程执行数据的操作。

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

    可以使用 /start:concurrency选项的下列选项中的任何一个。

    选项

    说明

    /user:[]usernamedomain\

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

    /crosssession

    允许分析其他登录会话中处理。

    /wincounter:WinCounterPath

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

    /automark:Interval

    只 /wincounter 的使用。 指定毫秒数。 windows 性能计数器收集事件之间的。 默认值为 500 毫秒。

    /events:Config

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

  3. 启动目标应用程序。 类型:

    VSPerfCmd/launch**:**AppNameOptions[] []Sample Event

    可以使用 /launch 选项的下列选项中的任何一个。

    选项

    说明

    /args:Arguments

    指定包含命令行参数将传递给目标应用程序的字符串。

    /console

    在单独的窗口中启动目标命令行应用程序。

    /targetclr:Version

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

控制数据收集

在目标应用程序运行期间，通过使用 VSPerfCmd.exe 选项，则通过启动和停止写入数据来控制数据收集到文件。 控制数据收集可以收集数据提供程序执行的特定阶段，如启动或关闭应用程序) 的。

启动和停止数据收集

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

    选项

    说明

    /globalon /globaloff

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

    /processon:PID/processoff:PID

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

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

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

若要结束分析会话

若要结束分析会话，探查器将无法收集数据。 可以停止收集并发数据通过关闭分析的应用程序或调用 VSPerfCmd /detach 选项。 然后调用 VSPerfCmd /shutdown 选项关闭探查器并关闭分析数据文件。 VSPerfClrEnv /off 命令清除分析环境变量。

结束分析会话

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

    • 关闭目标应用程序。

      - 或 -

    • 键入 VSPerfCmd /detach

  2. 关闭探查器

    VSPerfCmd/shutdown

请参见

概念

使用探查器命令行收集独立应用程序的并发数据

修订记录

日期

历史记录

原因

2011 年十二月

移除了 VSPerfClrEnv /sampleon 步骤。

内容 Bug 修复。