8.185 V$RSRC_CONS_GROUP_HISTORY

V$RSRC_CONS_GROUP_HISTORY displays a history of consumer group statistics for each entry in V$RSRC_PLAN_HISTORY that has a non-NULL plan.

When the STATISTICS_LEVEL is set to TYPICAL or ALL, this view contains information about CPU utilization and wait times even when no Resource Manager plan is set or when the Resource Manager plan does not monitor CPU or session resources.

A new window is created in V$RSRC_CON_GROUP_HISTORY when a pluggable database (PDB) changes its resource plan. The plan windows inside a PDB are not impacted by a multitenant container database (CDB) resource plan change.

Since PDB plans can be set independently across different PDBs, V$RSRC_CON_GROUP_HISTORY will not cover the same time period across different PDBs. Therefore, this view is not useful for comparing statistics across different PDBs.

Column Datatype Description

SEQUENCE#

NUMBER

A sequential counter that uniquely describes the V$RSRC_PLAN_HISTORY entry to which these consumer group statistics apply. When the instance is restarted, this value is reset to zero.

ID

NUMBER

Consumer group object ID (a unique number, consistent across database shutdowns and startups)

NAME

VARCHAR2(30)

Name of the consumer group

REQUESTS

NUMBER

Cumulative number of requests that were executed in the consumer group

CPU_WAIT_TIME

NUMBER

Cumulative amount of time that sessions waited for CPU on the resmgr: cpu quantum wait event because of resource management (in milliseconds). This does not include waits due to latch or enqueue contention, I/O waits, and so on. When CPU resources are not being actively managed, this value is set to zero.

CPU_WAITS

NUMBER

Cumulative number of times all sessions in the consumer group had to wait for CPU on the resmgr: cpu quantum wait event because of resource management. This does not include waits due to latch or enqueue contention, I/O waits, and so on. When CPU resources are not being actively managed, this value is set to zero.

CONSUMED_CPU_TIME

NUMBER

Cumulative amount of CPU time consumed by all sessions in the consumer group (in milliseconds)

YIELDS

NUMBER

Cumulative number of times that sessions in the consumer group had to yield CPU to other sessions because of quantum expiration. When CPU resources are not being actively managed, this value is set to zero.

CPU_DECISIONS

NUMBER

Percentage of CPU decisions for which the consumer group was present. When CPU resources are not being actively managed, this value is set to zero.

CPU_DECISIONS_EXCLUSIVE

NUMBER

Percentage of the CPU decisions for which the consumer group was present and was the only consumer group present. When CPU resources are not being actively managed, this value is set to zero.

CPU_DECISIONS_WON

NUMBER

Percentage of the CPU decisions that the consumer group won. When CPU resources are not being actively managed, this value is set to zero.

ACTIVE_SESS_LIMIT_HIT

NUMBER

Number of times that sessions in the consumer group were queued because the consumer group reached its active session limit

UNDO_LIMIT_HIT

NUMBER

Number of times that queries in the consumer group were canceled because the consumer group reached its UNDO_POOL limit

SWITCHES_IN_CPU_TIME

NUMBER

Number of switches into the consumer group because of the Resource Manager plan's SWITCH_TIME limit

SWITCHES_OUT_CPU_TIME

NUMBER

Number of switches out of the consumer group because of the Resource Manager plan's SWITCH_TIME limit

SWITCHES_IN_IO_MEGABYTES

NUMBER

Number of switches into the consumer group because of the Resource Manager plan's SWITCH_IO_MEGABYTES limit

SWITCHES_OUT_IO_MEGABYTES

NUMBER

Number of switches out of the consumer group because of the Resource Manager plan's SWITCH_IO_MEGABYTES limit

SWITCHES_IN_IO_REQUESTS

NUMBER

Number of switches into the consumer group because of the Resource Manager plan's SWITCH_IO_REQS limit

SWITCHES_OUT_IO_REQUESTS

NUMBER

Number of switches out of the consumer group because of the Resource Manager plan's SWITCH_IO_REQS limit

SWITCHES_IN_IO_LOGICAL

NUMBER

Number of switches into the consumer group because of the Resource Manager plan's SWITCH_IO_LOGICAL limit

SWITCHES_OUT_IO_LOGICAL

NUMBER

Number of switches out of the consumer group because of the Resource Manager plan's SWITCH_IO_LOGICAL limit

SWITCHES_IN_ELAPSED_TIME

NUMBER

Number of switches into the consumer group because of the Resource Manager plan's SWITCH_ELAPSED_TIME limit

SWITCHES_OUT_ELAPSED_TIME

NUMBER

Number of switches out of the consumer group because of the Resource Manager plan's SWITCH_ELAPSED_TIME limit

SQL_CANCELED

NUMBER

Number of times that SQL queries running in the consumer group were aborted because they exceeded one of the Resource Manager plan's SWITCH limits and CANCEL_SQL was specified as the Resource Manager plan's SWITCH_GROUP

ACTIVE_SESS_KILLED

NUMBER

Number of times that sessions running in the consumer group were terminated because they exceeded one of the Resource Manager plan's SWITCH limits and KILL_SESSION was specified as the Resource Manager plan's SWITCH_GROUP

IDLE_SESS_KILLED

NUMBER

Number of times that sessions in the consumer group were killed because they were idle for too long (reached MAX_IDLE_TIME)

IDLE_BLKR_SESS_KILLED

NUMBER

Number of times that sessions in the consumer group were killed because they were idle too long (reached MAX_IDLE_BLOCKER_TIME) and were blocking other sessions

QUEUED_TIME

NUMBER

Total amount of time that sessions in the consumer group have spent in the QUEUED state because of the active session limit (in milliseconds)

QUEUE_TIME_OUTS

NUMBER

Number of times that requests from sessions in the consumer group timed out because they were queued for too long (reached QUEUEING_P1)

IO_SERVICE_TIME

NUMBER

Cumulative I/O wait time (in milliseconds)

IO_SERVICE_WAITS

NUMBER

Total number of wait requests

SMALL_READ_MEGABYTES

NUMBER

Number of single block megabytes read

SMALL_WRITE_MEGABYTES

NUMBER

Number of single block megabytes written

LARGE_READ_MEGABYTES

NUMBER

Number of multiblock megabytes read

LARGE_WRITE_MEGABYTES

NUMBER

Number of multiblock megabytes written

SMALL_READ_REQUESTS

NUMBER

Number of single block read requests

SMALL_WRITE_REQUESTS

NUMBER

Number of single block write requests

LARGE_READ_REQUESTS

NUMBER

Number of multiblock read requests

LARGE_WRITE_REQUESTS

NUMBER

Number of multiblock write requests

PQS_COMPLETED

NUMBER

Total number of completed parallel statements in the consumer group

PQ_SERVERS_USED

NUMBER

Total number of parallel servers used by completed parallel statements in the consumer group

PQS_QUEUED

NUMBER

Number of times that sessions in the consumer group were queued when trying to run parallel statements

PQ_ACTIVE_TIME

NUMBER

Cumulative sum of the parallel active times for all completed parallel statements in the consumer group (in milliseconds)

PQ_QUEUED_TIME

NUMBER

Total amount of time that sessions in the consumer group were queued when trying to run parallel statements (in milliseconds)

PQ_QUEUE_TIME_OUTS

NUMBER

Number of times that parallel statements from sessions in the consumer group timed out because their queue time exceeded the Resource Manager plan's PARALLEL_QUEUE_TIMEOUT limit

PGA_LIMIT_SESSIONS_KILLEDFoot 1

NUMBER

Number of times that sessions in the consumer group were killed because their untunable PGA usage exceeded the SESSION_PGA_LIMIT limit

CON_ID

NUMBER

The ID of the container to which the data pertains. Possible values include:

  • 0: This value is used for rows containing data that pertain to the entire CDB. This value is also used for rows in non-CDBs.

  • 1: This value is used for rows containing data that pertain to only the root

  • n: Where n is the applicable container ID for the rows containing data

Footnote 1 This column is available starting with Oracle Database 18c.