WPR 操作说明主题

本部分介绍如何使用 Windows Performance Recorder (WPR) UI 来执行过程。 有关如何从命令行启动记录的信息,请参阅 WPR 命令行选项

开始记录

  1. 在“开始”屏幕上,单击“Windows Performance Recorder”。

  2. 若要运行默认配置文件,请单击“开始”。 或者,若要查看和使用其他配置文件,请单击“更多选项”。

    1. 在“为性能记录选择配置文件”框中,选择至少一个配置文件。

    2. 你可以选择添加自定义配置文件。 为此,单击“添加配置文件”,导航到所需的配置文件,然后单击“打开”。 在“自定义测量”下,选择配置文件。

    3. 从“性能方案”下拉列表中,选择所需的方案。 除非记录是针对开/关场景,否则选择“常规”。

    4. 你可以选择在粗略细节级别进行记录。 (详细是 default.level.) 为此,请在“详细信息”级别下拉列表中选择“浅色”。

    5. 若要将记录记录到文件中,请在“记录模式”下拉列表中选择“文件”。 “内存”是默认记录模式,开/关转换日志除外,它必须记录到文件中。

      注意 对于较长的记录,请选择“内存”。 选择“文件”时,文件可能会变得非常大,因为文件大小的唯一限制是可用磁盘空间。 Windows Performance Analyzer (WPA) 无法分析超大文件。

  3. 单击“启动”以开始记录,或者单击“取消”以结束记录。

注意 如果在运行另一个 WPR 发起的会话期间尝试在 WPR 中启动录制,WPR 将检测冲突并提示你进行以下查询:

An existing session is already running. Click OK to stop the running session and start the selected profile(s) or Cancel to abort the operation.

若要停止当前会话,请单击“确定”。 WPR 将开始记录。 请注意,此操作可能会影响启动了已取消会话的应用程序。 若要允许当前会话继续,请单击“取消”。 在这种情况下,WPR 不会开始记录,并且其他应用程序不受影响。

查看记录状态

使用 WPR 用户界面 (UI) 开始记录时,记录状态会立即显示在 WPR 屏幕上。 如果是使用 WPR 命令行界面开始记录,可以通过以下任一方法查看记录状态:

  • 在命令提示符窗口中,键入 wpr –status。 有关此命令的详细信息,请参阅 WPR 命令行选项

  • 打开 WPR UI。 此时将显示从 WPR 命令行启动的记录的状态。

注意:如果记录是由 WPR 启动的,则 WPR 只显示记录的状态。 它无法显示由 Xperf 或其他应用程序启动的记录的记录状态。

记录状态显示以下信息:

  • 记录时间:记录运行的时间长度。

  • 缓冲区:记录使用的缓冲区大小。 它以 MB 和可用共用内存的百分比显示。

  • 丢失的事件:自记录开始以来丢失的事件数。 有关此问题的详细信息,请参阅避免丢失事件

停止记录

  1. 在 WPR 屏幕上,单击“保存”。 (如果单击“取消”,则不会保存记录。)

  2. 浏览到要将记录文件保存到的位置。

  3. 输入为其创建记录的问题的说明。

  4. 单击“保存”,然后单击“确定”。

    如果事件已丢失,则将显示一条警告。 有关如何避免此问题的指南,请参阅避免丢失事件

安全性

记录可以包含个人身份信息或与安全相关的信息。 其中包括记录访问的文件的路径,或注册表访问和进程名称。 共享记录文件时要谨慎。

添加或删除自定义记录配置文件

  1. 在 WPR 屏幕上,如果选项被隐藏,请单击“更多选项”。

  2. 单击“添加配置文件”。

  3. 导航到包含配置文件的位置,选择 .wprp 文件,然后单击“打开”。 在将 .wprp 文件添加到配置文件之前,WPR 将验证 .wprp 文件的架构。

  4. 重复步骤 2 和步骤 3 以添加其他配置文件。 单个记录最多可以使用 64 个配置文件。

添加的配置文件将显示在“自定义测量”下。

删除记录配置文件

  1. 在 WPR 屏幕上,如果选项被隐藏,请单击“更多选项”。

  2. 右键单击要删除的自定义配置文件,然后单击“删除配置文件”。

只有显示自定义配置文件时,“删除配置文件”按钮才可见。 只能删除自定义配置文件:无法删除内置配置文件。

更改性能方案

  1. 在 WPR 屏幕上,如果选项被隐藏,请单击“更多选项”。

  2. 在“性能方案”下拉列表中,选择所需的方案。 默认值为“常规”。

更改详细信息级别

  1. 在 WPR 屏幕上,如果选项处于隐藏状态,请单击“更多选项”。

  2. 在“详细信息级别”下拉列表中,选择想要的详细信息级别。 默认级别为“详细”。

更改日志记录模式

  1. 在 Windows 8“开始”屏幕上,单击“Windows Performance Recorder”。

  2. 单击“更多选项”。

  3. 从“日志记录模式”下拉列表中选择日志记录模式。 默认模式为“内存”。

注意 对于较长的记录,请选择“内存”。 选择“文件”时,文件可能会变得非常大,因为文件大小的唯一限制是可用磁盘空间。 如果文件太大,可能无法在 Windows Performance Analyzer (WPA) 中对其进行分析。

创建自定义记录配置文件

可以在扩展名为 .wprp 的 XML 文件中创建自定义配置文件。 有关完整架构和参考信息,请参阅 录制配置文件 XML 参考 。 有关创作录制配置文件的详细信息,请参阅创作录制 配置文件

创建自定义记录配置文件

  1. 在 XML 编辑器中,创建一个新的 XML 文件。

  2. 输入收集器定义。 有关详细信息,请参阅 1. 收集器定义

  3. 输入系统和事件提供程序定义。 有关详细信息,请参阅 2. 系统和事件提供程序定义

注意:如果希望在某些提供程序未启动时停止和回滚自定义配置文件,请将“严格”属性设置为“true”。 有关此选项的详细信息,请参阅严格的提供程序

  1. 输入配置文件定义。 有关详细信息,请参阅 3. 配置文件定义

  2. 以 .wprp 扩展名保存该文件。

可以定义派生的收集器、提供程序和配置文件,它们继承自你先前在同一文件或其他文件中定义的基础版本。 有关此选项的详细信息,请参阅继承

避免丢失事件

某些应用程序生成这么多事件,Windows (ETW 事件跟踪) 无法跟上日志记录频率。 此问题表现为在记录中丢失事件。 由于数据不完整,该问题可能会导致分析困难或错误结论。

注意 默认情况下,WPR 对缓冲区使用分页内存。 若要将 WPR 设置为对缓冲区使用非分页内存,请将提供程序的“NonPagedMemory”属性设置为“true”。 有关如何创建自定义配置文件的详细信息,请参阅创作记录配置文件2. 系统和事件提供程序定义

你可以通过以下方式帮助防止 WPR 丢失 ETW 缓冲区或事件:

  • 当 WPR 将缓冲区写入磁盘时,使用更大的缓冲区来启用更高效的磁盘 I/O。

  • 首次在计算机上使用特定缓冲区配置时,对数据收集的请求进行计数。

  • 使用命令行 recordTempTo 选项记录到与默认位置不同的位置。

  • 增加缓冲区的数量。

  • 简化要测试的方案,或选择更少的配置文件。

  • 释放系统驱动器上的磁盘空间。

  • 使用高级硬件收集数据;例如,使用吞吐量更高的磁盘子系统。 这是要考虑的最后一个选项。 通常可以通过仔细选择要启用的提供程序和使用的缓冲区来避免丢失事件。

Windows Performance Recorder

WPR 常见方案

WPR 功能

会话

会话(Windows 驱动程序)