SQL Server 扩展事件目标

事件存入桶目标

事件存入桶目标基于事件数据对特定事件类型的发生进行分组。“存储桶”是基于特定事件列或操作进行计数的一组事件。您可以使用事件存入桶目标来排除性能问题。通过标识哪些事件发生的频率最高，您就可以找到可能引起性能问题的“作用点”。

下表描述了能够用来配置事件存入桶目标的选项。

SELECT p.name, se.event_name
FROM sys.dm_xe_session_events se
JOIN sys.dm_xe_packages p
ON se_event_package_guid = p.guid
ORDER BY p.name, se.event_name

SELECT name FROM sys.dm_xe_object_columns
WHERE object_name = '<eventname>'
AND column_type != 'readonly'

下例说明了事件存入桶目标如何在高级别收集数据。在此示例中，您希望使用事件存入桶目标来计数每种等待类型中发生的等待数。为此，您将会在定义事件存入桶目标时指定以下选项：

• filtering_event_name = 'wait_info'

• source = 'wait_type'

• source_type = 0（因为 wait_type 是个事件列）

在此示例中，针对 wait_type 源记录了以下数据。

等待类型值可以通过以下值和槽计数而划分为三个存入桶：

有关事件存入桶目标语法的详细信息，请参阅如何使用扩展事件监视系统活动。

存入桶目标只保留指定源的事件数据。某些情况下，事件数据可能太大而无法完全保留，这时便会截断数据。截断事件数据后，将记录字节数并以 XML 输出方式显示出来。

存入桶目标将数据以 XML 格式序列化到一个调用程序或过程中。

注意
存入桶输出不遵从任何架构。

下例说明了存入桶目标的输出格式。

<Slots truncated = "0" buckets=[count]>
    <Slot count=[count] trunc=[truncated bytes]>
        <value>
        </value>
    </Slot>
</Slots>

事件配对目标

事件配对目标使用两个事件中存在的一列或多列数据来对这两个事件进行匹配。许多事件是成对的，例如，锁获取和锁释放。对某个事件序列配对完毕，便会放弃这两个事件。放弃匹配完毕的事件便于检测哪些获取的锁尚未释放。

通过使用事件级别筛选器，可以使用配对目标仅捕获那些与预设条件不匹配的事件。

使用事件配对目标时，可以选择两个要匹配的事件和一个序列，此序列由要对其进行匹配的列构成。此序列中的所有列必须属于同一类型。

下表描述了配置事件配对时可用的选项。

系统将捕获并存储与某个事件相关联的所有数据，以供将来配对之用。此外，还将收集由操作添加的数据。收集的事件数据存储在内存中，因此会有一定的限制。此限制基于系统容量和活动。所用内存量将根据可用系统资源来决定，而不是以最大内存量作为限定因素。内存不足时，将删除已经保留的不成对事件。如果某事件尚未成对便被删除，则与之匹配的事件将作为不成对事件出现。

配对目标会将不成对事件序列化为 XML 格式。此格式不遵从任何架构，只包含两种元素类型。<unpaired> 元素是根元素，后跟一个 <event> 元素（对于当前正跟踪的每个不成对事件）。<event> 元素包含一个属性，其中包含不成对事件的名称。

下例说明了配对目标的输出格式。

<unpaired truncated = "0" matchedCount = "[matched count]" memoryPressureDroppedCount = " [lost count]">
    <event name  = "[event name]" package = "[package]" id= "[event ID value]" version = "[event version]">
    <data name = "[column name]"> 
    <type name = "[column type]" package = "[type package]" /> 
    <value>[column value]</value>
    <text value>[text value]</text>>
        </data>
    </event>
</unpaired>

Windows 事件跟踪目标

在将 Windows 事件跟踪 (ETW) 作为目标使用前，建议您先掌握 ETW 的相关使用知识。ETW 跟踪或者与扩展事件结合使用，或者用作扩展事件的事件使用者。您可以从以下外部链接入手，获取有关 ETW 的背景信息：

• Windows 事件

• 使用 ETW 改善调试和性能优化

扩展事件支持 Windows XP 和 Windows Server 2003 版本的 ETW。ETW 目标是单独目标，尽管该目标可以被添加到多个会话中。如果某事件在多个会话中被引发，则该事件在每次发生事件时仅被传播给 ETW 目标一次。每个进程仅限一个扩展事件引擎实例。

重要提示
为使 ETW 目标能够工作，SQL Server 服务启动帐户必须是性能日志用户组的成员。

对于 ETW 会话中存在的事件，其配置由承载扩展事件引擎的进程来控制。引擎控制着激发哪些事件，以及必须满足哪些条件才能激发事件。

在绑定到扩展事件会话之后，即在进程的生存期中首次附加 ETW 目标之后，ETW 目标会在 SQL Server 访问接口上打开一个单独的 ETW 会话。如果已经存在 ETW 会话，ETW 目标将获取对现有会话的引用。此 ETW 会话由给定计算机上的所有 SQL Server 实例共享，并从具有此 ETW 目标的会话接收所有事件。

由于 ETW 需要启用访问接口才能使用事件并将事件发送给 ETW 会话，因而对此会话启用所有扩展事件包。激发事件后，ETW 目标将事件发送给对其启用了事件访问接口的会话。

ETW 目标支持对激发事件的线程同步发布事件。但是，ETW 目标不支持异步事件发布。

ETW 目标不支持来自外部 ETW 控制器（例如 logman.exe）的控制。若要生成 ETW 跟踪，必须使用 ETW 目标创建事件会话。有关详细信息，请参阅 CREATE EVENT SESSION (Transact-SQL)。

注意
启用 ETW 目标将创建一个名为 XE_DEFAULT_ETW_SESSION 的 ETW 会话。如果名为 XE_DEFAULT_ETW_SESSION 的会话已经存在，则使用该会话而不修改现有会话的任何属性。XE_DEFAULT_ETW_SESSION 由所有 SQL Server 实例共享。启动了 XE_DEFAULT_ETW_SESSION 后，必须使用 ETW 控制器（如 Logman 工具）停止它。例如，可以在命令提示符处运行以下命令：logman stop XE_DEFAULT_ETW_SESSION -ets。

下表介绍了配置 ETW 目标时可用的选项。

上述设置的配置是可选的。ETW 目标使用这些设置的默认值。

ETW 目标负责下列操作：

• 创建默认的 ETW 会话。

• 向 ETW 注册所有扩展事件包。这样可以确保 ETW 不会删除事件。

• 管理事件向 ETW 的发送。ETW 目标使用扩展事件数据创建 ETW 事件并将其发送给相应的 ETW 会话。如果事件的大小超过缓冲区的大小，或数据无法容纳到一个 ETW 事件中，则 ETW 将把事件拆分成几个片段。

• 使扩展事件包在任何时候均保持为启用状态。

ETW 使用以下默认文件位置：

• ETW 输出文件的格式为 %TEMP%\XEEtw.etl。

  重要提示
  当第一个会话启动后不能再更改该文件路径。

• 托管对象格式 (MOF) 文件位于 <您的安装路径>\Microsoft SQL Server\Shared 下。有关详细信息，请参阅 MSDN 上的 Managed Object Format（管理对象格式）。

事件文件目标

事件文件目标是可将完整的缓冲区写入磁盘的异步目标。文件目标可创建两种类型的文件，即日志文件和元数据文件。元数据文件对目标输入日志文件中的事件内容进行说明。这样，就可以正确地分析日志文件中的所有事件，并可正确分析与事件关联的操作数据。

若要使用此目标，必须指定日志文件和元数据文件的位置名称。其他配置选项，例如文件大小和增长特征等都是可选项。

下表描述了配置事件文件目标时可用的选项。

第一次创建文件目标时，会在指定的文件名后面附加 _0_ 以及一个长整型值。该整型值被计算为 1600 年 1 月 1 日与文件的创建时间之间的毫秒数。后续的回滚文件也将使用此格式。通过检查该长整型值，可以确定最新的文件。以下示例演示了文件的命名方式。在该方案中，将文件名选项指定为 C:\OutputFiles\MyOutput.xel：

• 创建的第一个文件 - C:\OutputFiles\MyOutput_0_128500310259380000.xel

• 第一个滚动更新文件 - C:\OutputFiles\MyOutput_0_128505831770890000.xel

• 第二个滚动更新文件 - C:\OutputFiles\MyOutput_0_132410772966237000.xel

同步事件计数器目标

同步事件计数器目标将计算在扩展事件会话过程中激发的所有事件数目。使用同步事件计数器目标可以获取有关工作负荷特征的信息而不必因进行完整的事件收集而增加系统开销。此目标不包含任何可自定义的参数。

下例说明了同步事件计数器目标的输出。

<CounterTarget truncated = "0">
  <Packages>
    <Package name = "[package name]">
      <Event name = "[event name]" count = "[number]" />
    </Package>
  </Packages>
</CounterTarget>

环形缓冲区目标

环形缓冲区目标主要是在内存中容纳事件数据。此目标可通过以下两种模式中的一种来管理事件。

• 第一种模式是严格的先进先出 (FIFO)，在这种模式下，当分配给目标的所有内存都用尽时，将放弃最旧的事件。在这种模式下（默认模式），occurrence_number 选项设为 0。

• 第二种模式是按事件 FIFO，在这种模式下，每种类型将保留指定数量的事件。在这种模式下，当分配给目标的所有内存都用尽时，将放弃每种类型的最旧的事件。您可以配置 occurrence_number 选项来指定要保留的每种类型的事件数。

下表描述了配置环形缓冲区目标时可用的选项。

下面的示例说明了环形缓冲区目标的输出。

<RingBufferTarget eventsPerSec="" processingTime="" totalEventsProcessed="" eventCount="" droppedCount="" memoryUsed="">
 <event name="" package="" id="" version="" timestamp="">
    <data name="">
      <type name="" package="" />
      <value></value>
      <text></text>
    </data>
    <action name="" package="">
      <type name="" package="" />
      <value></value>
      <text></text>
    </action>
  </event>
</RingBufferTarget>

更改历史记录

请参阅

概念