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

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

始める前に

パッケージ・キャッシュ・イベント・モニターのデータを収集するには、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. レポートを分析します。

例

以下は、パッケージ・キャッシュ・イベント・モニターが未フォーマット・イベント表に収集したデータを、Java™ ベースのレポート・ツール db2evmonfmt を使用して変換することによって得られるレポートの例です。
-------------------------------------------------------
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