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 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'

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 ソースに対して次のデータが記録されます。

待機の種類値は、次の値とスロット数を持つ 3 つのバケットに分類されます。

イベント バケット ターゲットの構文の詳細については、「拡張イベントを使用してシステムの使用状況を監視する方法」を参照してください。

バケット ターゲットによって保持されるのは、指定されたソースのイベント データだけです。イベント データが大きすぎて全体を保持することができない場合もあります。その場合は、データが切り捨てられます。イベント データが切り捨てられた場合、バイト数が記録されて、XML 出力として表示されます。

バケット ターゲットは、呼び出し元のプログラムまたはプロシージャに対するデータを XML 形式でシリアル化します。

注
バケット出力は、いずれのスキーマにも準拠しません。

次の例は、バケット ターゲットの出力形式を示しています。

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

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

イベント ペアリング ターゲット

イベント ペアリング ターゲットは、各イベントに存在する単一列または複数列のデータを使って 2 つのイベントを照合します。ロックの取得とロックの解放など、対で発生するイベントが数多く存在します。イベント シーケンスが対で発生した後は、両方のイベントが破棄されます。一対のイベントを破棄することによって、取得されたまま解放されていないロックを容易に検出できます。

イベント レベルのフィルターを使用すると、設定済みの条件に合致しないイベントだけを、ペアリング ターゲットを使ってキャプチャできます。

イベント ペアリング ターゲットを使用する場合は、照合に使用する列のシーケンスのほか、照合する 2 つのイベントを選択できます。このシーケンス内のすべての列は、同じ型であることが必要です。

次の表では、イベント ペアリングの構成に使用できるオプションについて説明します。

イベントに関連付けられているすべてのデータはキャプチャされて、その後のペアリングに備えて保存されます。また、アクションによって追加されたデータも収集されます。収集されたイベント データはメモリに格納されるため、格納できるサイズには上限があります。この制限は、システムの容量とアクティビティに依存します。使用メモリ量は利用可能なシステム リソースに基づくため、使用可能な最大メモリ量をパラメーターとして指定することはありません。システム リソースが不足した場合、それまで保持されていた、対になっていないイベントは破棄されます。イベントが対になっておらず破棄された場合、照合イベントは、対になっていないイベントとして発生します。

対になっていないイベントは、ペアリング ターゲットによって XML 形式にシリアル化されます。この形式は、いずれのスキーマにも準拠しません。この形式に含まれる要素は 2 種類だけです。ルートは <unpaired> 要素で、その後に、対になっていないイベント (現在追跡中のイベント) ごとに 1 つの <event> 要素が存在します。<event> 要素には、対になっていないイベントの名前を保持する属性が 1 つ存在します。

次の例は、ペアリング ターゲットの出力形式を示しています。

<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>

<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>

Event Tracing for Windows ターゲット

Event Tracing for Windows (ETW) をターゲットとして使用する前に、ETW を活用するための知識を身に付けておくことをお勧めします。ETW トレースは、拡張イベントと組み合わせて使用されるか、拡張イベントのイベント コンシューマーとして使用されます。ETW の背景情報については、次の外部リンクを参照してください。

• Windows イベント

• ETW によりデバッグおよびパフォーマンス調整を改善する

拡張イベントは、Windows XP および Windows Server 2003 バージョンの ETW をサポートしています。ETW ターゲットは、多くのセッションに追加できますが、シングルトン ターゲットです。多くのセッションでイベントが発生した場合、イベントは、イベントの発生ごとに 1 回、ETW ターゲットのみに反映されます。拡張イベント エンジンは、プロセスあたり 1 つのインスタンスに制限されます。

重要
ETW ターゲットを動作させるには、SQL Server サービス開始アカウントが Performance Log Users グループのメンバーであることが必要です。

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 を開始した後に停止する場合は、Logman ツールなどの ETW コントローラーを使用する必要があります。たとえば、コマンド プロンプトで logman stop XE_DEFAULT_ETW_SESSION -ets コマンドを実行できます。

次の表では、ETW ターゲットの構成に使用できるオプションについて説明します。

以上の設定は省略できます。これらの設定については既定値が使用されます。

ETW ターゲットは、次のような役割を持ちます。

• 既定の ETW セッションを作成する。

• すべての拡張イベント パッケージを ETW に登録する。これによって、ETW に登録されたイベントは破棄されなくなります。

• ETW に対するイベント フローを管理する。ETW ターゲットは、拡張イベント データを持つ ETW イベントを作成して、それを適切な ETW セッションに送信します。イベントがバッファー サイズを超えた場合、またはデータを 1 つの ETW イベントに収めることができなかった場合、そのイベントは ETW によって複数のフラグメントに分割されます。

• 拡張イベント パッケージを常時有効に保つ。

次に ETW で使用される既定のファイル パスを示します。

• ETW 出力ファイルは %TEMP%\XEEtw.etl に格納されます。

  重要
  最初のセッションの開始後にファイル パスを変更することはできません。

• マネージ オブジェクト形式 (MOF) のファイルは <インストール パス>\Microsoft SQL Server\Shared に格納されます。詳細については、MSDN の「マネージ オブジェクト形式」を参照してください。

イベント ファイル ターゲット

イベント ファイル ターゲットは、完全なバッファーをディスクに書き込む非同期ターゲットです。ファイル ターゲットによって、ログとメタデータの 2 種類のファイルが作成されます。メタデータ ファイルでは、ターゲット出力ログ ファイルに含まれるイベントの内容を記述します。これにより、ログ ファイル内のすべてのイベントを正しく解析できるようになり、イベントに関連付けられたアクション データも解析できるようになります。

このターゲットを使用するには、ログ ファイルとメタデータ ファイルの場所名を指定する必要があります。ファイル サイズや拡張特性などの他の構成オプションは省略可能です。

次の表では、イベント ファイル ターゲットの構成に使用できるオプションについて説明します。

ファイル ターゲットが初めて作成されるとき、指定したファイル名に 0 と長整数値が付加されます。整数値は、1600 年 1 月 1 日からファイルが作成された日時までのミリ秒数として計算されます。後続のロールオーバー ファイルでもこの形式が使用されます。長整数値を調べることで、最新のファイルを判別できます。次の例は、filename オプションに C:\OutputFiles\MyOutput.xel と指定した場合のファイルの名前の決定方法を示しています。

• 最初に作成されるファイル : C:\OutputFiles\MyOutput_0_128500310259380000.xel

• 最初のロールオーバー ファイル : C:\OutputFiles\MyOutput_0_128505831770890000.xel

• 2 番目のロールオーバー ファイル : C:\OutputFiles\MyOutput_0_132410772966237000.xel

同期イベント カウンター ターゲット

同期イベント カウンター ターゲットは、拡張イベント セッション中に発生したすべてのイベントをカウントします。同期イベント カウンター ターゲットを使用すると、完全なイベント コレクションのオーバーヘッドを追加することなく負荷の特性に関する情報を取得できます。このターゲットには、カスタマイズ可能なパラメーターはありません。

次の例は、同期イベント カウンター ターゲットの出力を示しています。

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

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

リング バッファー ターゲット

リング バッファー ターゲットは、メモリにイベント データを一時的に保持します。このターゲットでは、2 種類のモードのいずれかでイベントを管理できます。

• 1 つ目のモードは厳密な先入れ先出し (FIFO) です。このモードでは、ターゲットに割り当てられたメモリがすべて使用されると、最も古いイベントが破棄されます。このモード (既定値) では、occurrence_number オプションは 0 に設定されます。

• 2 つ目のモードはイベントごとの 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>

<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>

関連項目

概念