DB2 Version 9.7 for Linux, UNIX, and Windows

MON_GET_SERVICE_SUBCLASS 表関数 - サービス・サブクラスのメトリックの取得

MON_GET_SERVICE_SUBCLASS 表関数は、1 つ以上のサービス・サブクラスのメトリックを戻します。

構文


>>-MON_GET_SERVICE_SUBCLASS--(--service_superclass_name--,------>

>--service_subclass_name--,--member--)-------------------------><

スキーマは SYSPROC です。

表関数パラメーター

service_superclass_name: この関数を呼び出すときに現在接続されているデータベースで有効なサービス・スーパークラス名を指定する、タイプ VARCHAR(128) の入力引数。引数が NULL または空ストリングである場合、データベース内のすべてのスーパークラスについてメトリックが取得されます。
service_subclass_name: この関数を呼び出すときに現在接続されているデータベースで有効なサービス・サブクラス名を指定する、タイプ VARCHAR(128) の入力引数。引数が NULL または空ストリングである場合、データベース内のすべてのサブクラスについてメトリックが取得されます。
member: この関数を呼び出すときに現在接続されているデータベースと同じインスタンス内の有効なメンバーを指定する、タイプ INTEGER の入力引数。現行のデータベース・メンバーには -1、すべてのデータベース・メンバーには -2 を指定します。NULL 値を指定すると、-1 が暗黙的に設定されます。

許可

MON_GET_SERVICE_SUBCLASS 関数に対する EXECUTE 特権。

例

CPU 使用率で順序付けられる、使用された合計 CPU 時間と、各サービス・クラスの処理された要求の合計数を表示します。

SELECT varchar(service_superclass_name,30) as service_superclass,
                  varchar(service_subclass_name,30) as service_subclass, 
                  sum(total_cpu_time) as total_cpu, 
                  sum(app_rqsts_completed_total) as total_rqsts 
FROM TABLE(MON_GET_SERVICE_SUBCLASS('','',-2)) AS t 
GROUP BY service_superclass_name, service_subclass_name 
ORDER BY total_cpu desc

以下は、この照会の出力例です。

SERVICE_SUPERCLASS             SERVICE_SUBCLASS               ... 
------------------------------ ------------------------------ ... 
SYSDEFAULTUSERCLASS            SYSDEFAULTSUBCLASS             ... 
SYSDEFAULTMAINTENANCECLASS     SYSDEFAULTSUBCLASS             ...  
SYSDEFAULTSYSTEMCLASS          SYSDEFAULTSUBCLASS             ... 

  3 record(s) selected.

照会の出力 (続き)。

... TOTAL_CPU            TOTAL_RQSTS  
... -------------------- -------------------- 
...               967673                  100  
.. .                   0                    0  
...                    0                    0

使用上の注意

MON_GET_SERVICE_SUBCLASS 表関数で戻されるメトリックは、指示されたサービス・サブクラスの下で実行された要求についてのすべてのメトリックの累計を表します。メトリックは、作業単位境界でサービス・クラスにロールアップされ、要求の実行中には定期的にロールアップされます。したがって、この表関数で報告される値は、直前の ROLLUP 時のシステムの現行状態を反映しています。メトリックの値は確実に増加します。ある時間間隔に対する指定されたメトリックの値を判別するには、 MON_GET_SERVICE_SUBCLASS 表関数を使用してその間隔の始めと終わりのメトリックを照会し、差異を計算します。

要求メトリックは、サービス・スーパークラスに対する COLLECT REQUEST METRICS 節、およびデータベース・レベルの mon_req_metrics データベース構成パラメーターを介して制御されます。親サービス・スーパークラスで要求メトリックを使用可能にしているサービス・サブクラスのエージェントが要求を処理する場合にのみ、またはデータベース全体で要求メトリック・コレクションが有効な場合にのみ、その要求に対しメトリックが収集されます。デフォルトでは、要求メトリックはデータベース・レベルで使用可能です。要求メトリックがデータベース・レベルでもサービス・スーパークラスに対しても使用不可になっている場合、そのサービス・スーパークラスにマッピングされた接続ごとに報告されるメトリックは増加を停止します (または、要求メトリックがデータベースのアクティブ化時に無効であった場合には 0 のままになります)。

MON_GET_SERVICE_SUBCLASS 表関数は、サービス・サブクラスごとおよびメンバーごとに 1 行のデータを戻します。 (メンバー上の) サービス・クラス全体または (1 つ以上のサービス・クラスの) メンバー全体の集約は実行されません。ただし、集約は例に示されるように SQL 照会を使用して実行できます。この入力パラメーターの影響として、ANDing されます。したがって、競合する入力パラメーター (例えば、スーパークラス名 SUPA と SUPA のサブクラスではないサブクラス名 SUBB など) を指定する場合、行は戻されません。

ヒント: 要求は、複数のサービス・サブクラスで実行される場合があります。例えば、REMAP ACTIVITY アクションによってワークロード・マネージャー (WLM) しきい値を使用して要求を 1 つのサービス・サブクラスから別のサービス・サブクラスへマッピングする場合、この状況が生じる可能性があります。メトリックに使用された時間は、要求が実行されるサービス・サブクラスごとに更新されますが、要求カウンターは、要求が完了したサービス・サブクラスに対して増分します。したがって、単一のサブクラスの要求時間の平均を分析する必要はありません。アクティビティーをマッピングできるすべてのサブクラスは相互に関連付けて分析する必要があります。例えば、サービス・サブクラス A からサービス・クラス B にアクティビティーをマッピングできるしきい値があり、要求の平均を計算する場合、サービス・サブサービス A および B についてのカウンターおよびメトリックを集約し、その集約を使用して平均を計算する必要があります。

戻される情報

表 1. MON_GET_SERVICE_SUBCLASS について戻される情報
列名	データ・タイプ	説明または対応するモニター・エレメント
SERVICE_SUPERCLASS_NAME	VARCHAR(128)	service_superclass_name - サービス・スーパークラス名
SERVICE_SUBCLASS_NAME	VARCHAR(128)	service_subclass_name - サービス・サブクラス名
SERVICE_CLASS_ID	INTEGER	service_class_id - サービス・クラス ID
MEMBER	SMALLINT	member - データベース・メンバー
ACT_ABORTED_TOTAL	BIGINT	act_aborted_total - 打ち切られたアクティビティーの合計数
ACT_COMPLETED_TOTAL	BIGINT	act_completed_total - 完了したアクティビティーの合計数
ACT_REJECTED_TOTAL	BIGINT	act_rejected_total - リジェクトされたアクティビティーの合計数
AGENT_WAIT_TIME	BIGINT	agent_wait_time - エージェント待機時間
AGENT_WAITS_TOTAL	BIGINT	agent_waits_total - エージェント待機の合計
POOL_DATA_L_READS	BIGINT	pool_data_l_reads - バッファー・プール・データの論理読み取り
POOL_INDEX_L_READS	BIGINT	pool_index_l_reads - バッファー・プール索引の論理読み取り
POOL_TEMP_DATA_L_READS	BIGINT	pool_temp_data_l_reads - バッファー・プール一時データの論理読み取り
POOL_TEMP_INDEX_L_READS	BIGINT	pool_temp_index_l_reads - バッファー・プール一時索引の論理読み取り
POOL_TEMP_XDA_L_READS	BIGINT	pool_temp_xda_l_reads - バッファー・プール一時 XDA データの論理読み取り
POOL_XDA_L_READS	BIGINT	pool_temp_xda_l_reads - バッファー・プール一時 XDA データの論理読み取り
POOL_DATA_P_READS	BIGINT	pool_data_p_reads - バッファー・プール・データの物理読み取り
POOL_INDEX_P_READS	BIGINT	pool_index_p_reads - バッファー・プール索引の物理読み取り
POOL_TEMP_DATA_P_READS	BIGINT	pool_temp_data_p_reads - バッファー・プール一時データの物理読み取り
POOL_TEMP_INDEX_P_READS	BIGINT	pool_temp_index_p_reads - バッファー・プール一時索引の物理読み取り
POOL_TEMP_XDA_P_READS	BIGINT	pool_temp_xda_p_reads - バッファー・プール一時 XDA データの物理読み取り
POOL_XDA_P_READS	BIGINT	pool_xda_p_reads - バッファー・プール XDA データの物理読み取り
POOL_DATA_WRITES	BIGINT	pool_data_writes - バッファー・プールへのデータの書き込み
POOL_INDEX_WRITES	BIGINT	pool_index_writes - バッファー・プール索引の書き込み
POOL_XDA_WRITES	BIGINT	pool_xda_writes - バッファー・プール XDA データの書き込み
POOL_READ_TIME	BIGINT	pool_read_time - バッファー・プール物理読み取り時間の合計
POOL_WRITE_TIME	BIGINT	pool_write_time - バッファー・プール物理書き込み時間の合計
CLIENT_IDLE_WAIT_TIME	BIGINT	client_idle_wait_time - クライアントのアイドル待機時間
DEADLOCKS	BIGINT	deadlocks - デッドロック検出数
DIRECT_READS	BIGINT	direct_reads - データベースからの直接読み取り
DIRECT_READ_TIME	BIGINT	direct_read_time - 直接読み取り時間
DIRECT_WRITES	BIGINT	direct_writes - データベースへの直接書き込み
DIRECT_WRITE_TIME	BIGINT	direct_write_time - 直接書き込み時間
DIRECT_READ_REQS	BIGINT	direct_read_reqs - 直接読み取り要求
DIRECT_WRITE_REQS	BIGINT	direct_write_reqs - 直接書き込み要求
FCM_RECV_VOLUME	BIGINT	fcm_recv_volume - FCM 受信ボリューム
FCM_RECVS_TOTAL	BIGINT	fcm_recvs_total - FCM 合計受信数
FCM_SEND_VOLUME	BIGINT	fcm_send_volume - FCM 送信ボリューム
FCM_SENDS_TOTAL	BIGINT	fcm_sends_total - FCM 合計送信数
FCM_RECV_WAIT_TIME	BIGINT	fcm_recv_wait_time - FCM 受信待機時間
FCM_SEND_WAIT_TIME	BIGINT	fcm_send_wait_time - FCM 送信待ち時間
IPC_RECV_VOLUME	BIGINT	ipc_recv_volume - プロセス間通信受信ボリューム
IPC_RECV_WAIT_TIME	BIGINT	ipc_recv_wait_time - プロセス間通信受信待ち時間
IPC_RECVS_TOTAL	BIGINT	ipc_recvs_total - プロセス間通信合計受信数
IPC_SEND_VOLUME	BIGINT	ipc_send_volume - プロセス間通信送信ボリューム
IPC_SEND_WAIT_TIME	BIGINT	ipc_send_wait_time - プロセス間通信送信待ち時間
IPC_SENDS_TOTAL	BIGINT	ipc_sends_total - プロセス間通信合計送信数
LOCK_ESCALS	BIGINT	lock_escals - ロック・エスカレーション数
LOCK_TIMEOUTS	BIGINT	lock_timeouts - ロック・タイムアウト数
LOCK_WAIT_TIME	BIGINT	lock_wait_time - ロック待機中の時間
LOCK_WAITS	BIGINT	lock_waits - ロック待機数
LOG_BUFFER_WAIT_TIME	BIGINT	log_buffer_wait_time - ログ・バッファー待ち時間
NUM_LOG_BUFFER_FULL	BIGINT	num_log_buffer_full - フル・ログ・バッファーの回数
LOG_DISK_WAIT_TIME	BIGINT	log_disk_wait_time - ログ・ディスク待機時間
LOG_DISK_WAITS_TOTAL	BIGINT	log_disk_waits_total - ログ・ディスク待機の合計
RQSTS_COMPLETED_TOTAL	BIGINT	rqsts_completed_total - 完了した要求の合計数
ROWS_MODIFIED	BIGINT	rows_modified - 変更された行数
ROWS_READ	BIGINT	rows_read - 読み取り行数
ROWS_RETURNED	BIGINT	rows_returned - 戻り行数
TCPIP_RECV_VOLUME	BIGINT	tcpip_recv_volume - TCP/IP 受信ボリューム
TCPIP_SEND_VOLUME	BIGINT	tcpip_send_volume - TCP/IP 送信ボリューム
TCPIP_RECV_WAIT_TIME	BIGINT	tcpip_recv_wait_time - TCP/IP 受信待ち時間
TCPIP_RECVS_TOTAL	BIGINT	tcpip_recvs_total - TCP/IP 合計受信数
TCPIP_SEND_WAIT_TIME	BIGINT	tcpip_send_wait_time - TCP/IP 送信待ち時間
TCPIP_SENDS_TOTAL	BIGINT	tcpip_sends_total - TCP/IP 合計送信数
TOTAL_APP_RQST_TIME	BIGINT	total_app_rqst_time - アプリケーション要求合計時間
TOTAL_RQST_TIME	BIGINT	total_rqst_time - 合計要求時間
WLM_QUEUE_TIME_TOTAL	BIGINT	wlm_queue_time_total - ワークロード・マネージャー合計キュー時間
WLM_QUEUE_ASSIGNMENTS _TOTAL	BIGINT	wlm_queue_assignments_total - ワークロード・マネージャー合計キュー割り当て数
TOTAL_RQST_MAPPED_IN	BIGINT	total_rqst_mapped_in - マップで含められた要求の合計
TOTAL_RQST_MAPPED_OUT	BIGINT	total_rqst_mapped_out - マップで除外された要求の合計
TOTAL_CPU_TIME	BIGINT	total_cpu_time - 合計 CPU 時間
TOTAL_WAIT_TIME	BIGINT	total_wait_time - 合計待ち時間
APP_RQSTS_COMPLETED_TOTAL	BIGINT	app_rqsts_completed_total - 完了したアプリケーション要求の合計数
TOTAL_SECTION_SORT_TIME	BIGINT	total_section_sort_time - セクション・ソート時間合計
TOTAL_SECTION_SORT_PROC_TIME	BIGINT	total_section_sort_proc_time - セクション・ソート処理時間合計
TOTAL_SECTION_SORTS	BIGINT	total_section_sorts - セクション・ソート合計
TOTAL_SORTS	BIGINT	total_sorts - ソート合計
POST_THRESHOLD_SORTS	BIGINT	post_threshold_sorts - ポストしきい値ソート
POST_SHRTHRESHOLD_SORTS	BIGINT	post_shrthreshold_sorts - ポスト共有しきい値ソート
SORT_OVERFLOWS	BIGINT	sort_overflows - ソート・オーバーフロー
TOTAL_COMPILE_TIME	BIGINT	total_compile_time - コンパイル時間の合計
TOTAL_COMPILE_PROC_TIME	BIGINT	total_compile_proc_time - コンパイル処理時間の合計
TOTAL_COMPILATIONS	BIGINT	total_compilations - コンパイルの合計回数
TOTAL_IMPLICIT_COMPILE_TIME	BIGINT	total_implicit_compile_time - 暗黙的コンパイル時間の合計
TOTAL_IMPLICIT_COMPILE_PROC_TIME	BIGINT	total_implicit_compile_proc_time - 暗黙的コンパイルの処理時間の合計
TOTAL_IMPLICIT_COMPILATIONS	BIGINT	total_implicit_compilations - 暗黙的コンパイルの合計回数
TOTAL_SECTION_TIME	BIGINT	total_section_time - セクション時間の合計
TOTAL_SECTION_PROC_TIME	BIGINT	total_section_proc_time - セクション処理時間の合計
TOTAL_APP_SECTION_EXECUTIONS	BIGINT	total_app_section_executions - セクション実行の合計回数
TOTAL_ACT_TIME	BIGINT	total_act_time - 合計アクティビティー時間
TOTAL_ACT_WAIT_TIME	BIGINT	total_act_wait_time - 合計アクティビティー待機時間
ACT_RQSTS_TOTAL	BIGINT	act_rqsts_total - アクティビティー要求の合計
TOTAL_ROUTINE_TIME	BIGINT	total_routine_time - ルーチン時間の合計
TOTAL_ROUTINE_INVOCATIONS	BIGINT	total_routine_invocations - ルーチン呼び出しの合計回数
TOTAL_COMMIT_TIME	BIGINT	total_commit_time - コミット時間の合計
TOTAL_COMMIT_PROC_TIME	BIGINT	total_commit_proc_time - コミット処理時間の合計
TOTAL_APP_COMMITS	BIGINT	total_app_commits - アプリケーション・コミットの合計回数
INT_COMMITS	BIGINT	int_commits - 内部コミット数
TOTAL_ROLLBACK_TIME	BIGINT	total_rollback_time - ロールバック時間の合計
TOTAL_ROLLBACK_PROC_TIME	BIGINT	total_rollback_proc_time - ロールバック処理時間の合計
TOTAL_APP_ROLLBACKS	BIGINT	total_app_rollbacks - アプリケーション・ロールバックの合計回数
INT_ROLLBACKS	BIGINT	int_rollbacks - 内部ロールバック数
TOTAL_RUNSTATS_TIME	BIGINT	total_runstats_time - ランタイム統計時間の合計
TOTAL_RUNSTATS_PROC_TIME	BIGINT	total_runstats_proc_time - ランタイム統計の処理時間の合計
TOTAL_RUNSTATS	BIGINT	total_runstats - ランタイム統計の合計回数
TOTAL_REORG_TIME	BIGINT	total_reorg_time - 再編成時間の合計
TOTAL_REORG_PROC_TIME	BIGINT	total_reorg_proc_time - 再編成の処理時間の合計
TOTAL_REORGS	BIGINT	total_reorgs - 再編成の合計回数
TOTAL_LOAD_TIME	BIGINT	total_load_time - ロード時間の合計
TOTAL_LOAD_PROC_TIME	BIGINT	total_load_proc_time - ロード処理時間の合計
TOTAL_LOADS	BIGINT	total_loads - ロードの合計回数
CAT_CACHE_INSERTS	BIGINT	cat_cache_inserts - カタログ・キャッシュ挿入数
CAT_CACHE_LOOKUPS	BIGINT	cat_cache_lookups - カタログ・キャッシュ参照数
PKG_CACHE_INSERTS	BIGINT	pkg_cache_inserts - パッケージ・キャッシュ挿入
PKG_CACHE_LOOKUPS	BIGINT	pkg_cache_lookups - パッケージ・キャッシュ参照
THRESH_VIOLATIONS	BIGINT	thresh_violations - しきい値違反の回数
NUM_LW_THRESH_EXCEEDED	BIGINT	num_lw_thresh_exceeded - しきい値を超えた回数
IDA_SEND_WAIT_TIME	BIGINT	ida_send_wait_time - データ送信の待機に費やされた時間
IDA_SENDS_TOTAL	BIGINT	ida_sends_total - データの送信回数
IDA_SEND_VOLUME	BIGINT	ida_send_volume - 送信したデータの合計量
IDA_RECV_WAIT_TIME	BIGINT	ida_recv_wait_time - データ受信の待機に費やされた時間
IDA_RECVS_TOTAL	BIGINT	ida_recvs_total - データの受信回数
IDA_RECV_VOLUME	BIGINT	ida_recv_volume - 受信したデータの合計量
ADDITIONAL_DETAILS	BLOB(100K)	将来の利用のために予約済み