パッケージ・キャッシュ・イベント・データの収集およびレポートの生成

パッケージ・キャッシュ・イベント・モニターを使用して、データベースのパッケージ・キャッシュから フラッシュされたステートメント項目に関するデータを収集します。 未フォーマット・イベント表にパッケージ・キャッシュ・イベント・データが収集された後、このタスクの指示に従って、テキスト・レポートを取得します。

始める前に

パッケージ・キャッシュ・イベント・モニターのデータを収集するには、DBADM または SQLADM 権限が必要です。

このタスクについて

パッケージ・キャッシュ・イベント・モニターは、パッケージ・キャッシュ内にあったものについて関連履歴情報を収集します。 これは、SQL ステートメントの照会のパフォーマンスおよび問題判別に役立ちます。 パッケージ・キャッシュ・イベント・モニターが、データベース・パッケージ・キャッシュから収集する情報には、例えば以下の情報が含まれます。
  • 実行可能 ID (EXECUTABLE_ID)
  • 照会の見積コスト (QUERY_COST_ESTIMATE)
  • 項目がパッケージ・キャッシュからフラッシュされた時刻 (Event Timestamp)

このタスクでは、パッケージ・キャッシュ・イベント・データを収集するための手順を説明します。


の制約事項

DBADM または SQLADM 権限がない場合、入力データ値は表示できません。

プロシージャー

パッケージ・キャッシュ・イベントに関する詳細情報を収集するには、以下のステップを実行します。

  1. 次の例に示すように、CREATE EVENT MONITOR FOR PACKAGE CACHE ステートメントを使用して、 cachestmtevmon というパッケージキャッシュイベントモニターを作成します。
    CREATE EVENT MONITOR cachestmtevmon FOR PACKAGE CACHE
   WRITE TO UNFORMATTED EVENT TABLE
  2. cachestmtevmon というパッケージキャッシュイベントモニターを有効にするには、次のステートメントを実行します。
    SET EVENT MONITOR cachestmtevmon STATE 1
  3. ロック・イベント・モニターおよび作業単位イベント・モニターとは異なり、 パッケージ・キャッシュ・イベント・モニターは、イベント・モニターが活動化された後、自動的に データの収集を開始します。
  4. データベースに接続します。
  5. イベント・モニター情報を収集するアプリケーション、ワークロード、または SQL ステートメントを実行します。
  6. パッケージ・キャッシュのデータ収集をオフにするには、 以下のコマンドを実行して、イベント・モニターを非アクティブ化します。
    SET EVENT MONITOR cachestmtevmon STATE 0
  7. XML パーサーツール db2evmonfmt を使用してパッケージキャッシュイベントレポートを取得し、フォーマットされていないイベントテーブルに収集されたイベントデータに基づくフラットテキスト形式のレポートを作成します。例えば：
    java db2evmonfmt -d db_name -ue table_name -ftext -u user_id -p password
  8. レポートを分析します。

例

以下は、 db2evmonfmt のJava™ベースのレポートツールを使用して、パッケージキャッシュイベントモニターで収集したフォーマットされていないイベントテーブルのデータを変換して取得したレポートの例です
-------------------------------------------------------
Event ID               : 1
Event Type             : PKGCACHEBASE
Event Timestamp        : 2009-11-06-12.32.06.442020
Member                 : 0
Release                : 9070100
-------------------------------------------------------

Package Cache Details
---------------------
Section Type                           : D
Insert Timestamp                       : 2009-11-06-12.28.04.246930
Executable ID                          : 0100000000000000010000000000000000000000020020091106122804246932
Package Schema                         : 
Package Name                           : 
Package Version ID                     : 
Section Number                         : 
Effective Isolation                    : CS
Number Of Executions                   : 1
Number Of Executions With Metrics      : 1
Prep Time                              : 9
Last Metrics Update                    : 2009-11-06-12.28.07.905942
Executions By Coordinator              : 1
Executions By Coordinator With Metrics : 1
Statement Type                         : DDL, (not Set Constraints)
Query Cost Estimate                    : 1
Statement Package Cache ID             : 1151051235329
Statement Text                         : create event monitor cachestmtevmon for package cache write to unformatted event table
Compilation Environment                : 47454E5F434D504C010000000E000000800100000000000000000000000000000100000004000000000100000
                                         0000000020000000400000008010000000000000300000008000000100100000000B0FA040000000100000018
                                         010000B804B0FA050000000100000020010000B8040000060000000100000028010000B804000007000000010
                                         0000030010000B8040000080000000100000038010000B8040000090000000500000040010000B80400000A00
                                         00000800000048010000B80400000B0000000B00000050010000B8040000100000000A00000060010000B8040
                                         000130000000400000070010000000000000F0000000400000078010000000000000100000000000000050000
                                         00000000000000000000000000300000000000000030000000000000004E000000000000004E0000000000000
                                         04E0000000000000031202020200000002020444444444444000000000000000000000C000000000020091106
                                         12280400000000000000000000000000000000000100000000000000
Section Environment                    : 

Metrics
-------------------
WLM_QUEUE_TIME_TOTAL                : 0
WLM_QUEUE_ASSIGNMENTS_TOTAL         : 0
FCM_TQ_RECV_WAIT_TIME               : 0
FCM_MESSAGE_RECV_WAIT_TIME          : 0
FCM_TQ_SEND_WAIT_TIME               : 0
FCM_MESSAGE_SEND_WAIT_TIME          : 0
LOCK_WAIT_TIME                      : 0
LOCK_WAITS                          : 0
DIRECT_READ_TIME                    : 0
DIRECT_READ_REQS                    : 0
DIRECT_WRITE_TIME                   : 3
DIRECT_WRITE_REQS                   : 1
LOG_BUFFER_WAIT_TIME                : 0
NUM_LOG_BUFFER_FULL                 : 0
LOG_DISK_WAIT_TIME                  : 0
LOG_DISK_WAITS_TOTAL                : 0
POOL_WRITE_TIME                     : 0
POOL_READ_TIME                      : 33
AUDIT_FILE_WRITE_WAIT_TIME          : 0
AUDIT_FILE_WRITES_TOTAL             : 0
AUDIT_SUBSYSTEM_WAIT_TIME           : 0
AUDIT_SUBSYSTEM_WAITS_TOTAL         : 0
DIAGLOG_WRITE_WAIT_TIME             : 0
DIAGLOG_WRITES_TOTAL                : 0
FCM_SEND_WAIT_TIME                  : 0
FCM_RECV_WAIT_TIME                  : 0
TOTAL_ACT_WAIT_TIME                 : 36
TOTAL_SECTION_SORT_PROC_TIME        : 0
TOTAL_SECTION_SORTS                 : 0
TOTAL_SECTION_SORT_TIME             : 0
TOTAL_ACT_TIME                      : 37
TOTAL_ROUTINE_TIME                  : 0
STMT_EXEC_TIME                      : 3658
COORD_STMT_EXEC_TIME                : 3658
TOTAL_ROUTINE_NON_SECTION_PROC_TIME : 0
TOTAL_ROUTINE_NON_SECTION_TIME      : 0
TOTAL_SECTION_PROC_TIME             : 1
TOTAL_SECTION_TIME                  : 37
TOTAL_ROUTINE_USER_CODE_PROC_TIME   : 0
TOTAL_ROUTINE_USER_CODE_TIME        : 0
ROWS_READ                           : 19
ROWS_MODIFIED                       : 3
POOL_DATA_L_READS                   : 42
POOL_INDEX_L_READS                  : 83
POOL_TEMP_DATA_L_READS              : 0
POOL_TEMP_INDEX_L_READS             : 0
POOL_XDA_L_READS                    : 0
POOL_TEMP_XDA_L_READS               : 0
TOTAL_CPU_TIME                      : 2243
POOL_DATA_P_READS                   : 13
POOL_TEMP_DATA_P_READS              : 0
POOL_XDA_P_READS                    : 0
POOL_TEMP_XDA_P_READS               : 0
POOL_INDEX_P_READS                  : 33
POOL_TEMP_INDEX_P_READS             : 0
POOL_DATA_WRITES                    : 0
POOL_XDA_WRITES                     : 0
POOL_INDEX_WRITES                   : 0
DIRECT_READS                        : 0
DIRECT_WRITES                       : 2
ROWS_RETURNED                       : 0
DEADLOCKS                           : 0
LOCK_TIMEOUTS                       : 0
LOCK_ESCALS                         : 0
FCM_SENDS_TOTAL                     : 0
FCM_RECVS_TOTAL                     : 0
FCM_SEND_VOLUME                     : 0
FCM_RECV_VOLUME                     : 0
FCM_MESSAGE_SENDS_TOTAL             : 0
FCM_MESSAGE_RECVS_TOTAL             : 0
FCM_MESSAGE_SEND_VOLUME             : 0
FCM_MESSAGE_RECV_VOLUME             : 0
FCM_TQ_SENDS_TOTAL                  : 0
FCM_TQ_RECVS_TOTAL                  : 0
FCM_TQ_SEND_VOLUME                  : 0
FCM_TQ_RECV_VOLUME                  : 0
TQ_TOT_SEND_SPILLS                  : 0
POST_THRESHOLD_SORTS                : 0
POST_SHRTHRESHOLD_SORTS             : 0
SORT_OVERFLOWS                      : 0
AUDIT_EVENTS_TOTAL                  : 0
TOTAL_SORTS                         : 0
THRESH_VIOLATIONS                   : 0
NUM_LW_THRESH_EXCEEDED              : 0
TOTAL_ROUTINE_INVOCATIONS           : 0