Entities, metrics, and lookup details for Oracle Enterprise Manager


This topic explains the predefined metrics that are provided by the Oracle Enterprise Manager (OEM) and their mapping with the TrueSight Capacity Optimization metrics. The OEM provides metrics for entities, such as database server, database instance, database cluster, and Real Application Cluster (rac), and Automatic Storage Management (ASM). 

The ETL accesses the following views to collect metrics from the Oracle Enterprise Manager (OEM):

  • MGMT$METRIC_DAILY
  • MGMT$METRIC_DETAILS
  • MGMT$METRIC_HOURLY

According to the Oracle documentation, Oracle Diagnostics Pack must be enabled to view the listed repository views.  An additional license is required to enable the Oracle Diagnostics Pack. For details, see the Oracle Enterprise Manager documentation.

Database Server (dbs) metrics

Load

TrueSight Capacity Optimization metric

Description

OEM metric

CPU_UTIL_WAIO                 

Percentage of time the CPU was waiting for I/O during the interval.

cpuIOWait

CPU_UTIL 

Percentage of time the CPU was not idle during the interval.

cpuUtil

CPU_UTIL_USER 

The percentage of time the CPU was in user mode during the interval.

cpuUser

CPU_RUN_QUEUE 

CPU Run Queue Length

cpuLoad

MEM_UTIL 

The percentage of physical memory in use during the interval.

memUsedPct

MEM_ACTIVE 

Sum of the physical memory sizes of the data and stack regions for processes that are currently on the run queue or processes that have executed recently, in percentage over physical memory

activeMem

DISK_IO_RATE 

Disk Average I/O Rate aggregated by host

totIO

CPU_UTIL_SYSTEM 

Percentage of time the CPU was in system mode during the interval for each CPU of the system. The subobject specifies the CPU id.

cpuKernel

DISK_SVC_TIME 

Disk Average Service Time aggregated by host

longestServ

PROCESS_NUM_RUNNING 

Running Process Num

noOfProcs

MEM_PAGE_SCAN_RATE 

The number of pages scanned per second by the VMM during the interval.

pgScanRate

SWAP_SPACE_UTIL 

The percentage of utilization of the swap space. The subobject specifies the disk name.

swapUtil

MEM_REAL_UTIL

The percentage of logical memory in use during the interval.

usedLogicalMemoryPct

Disk activity summary (DiskActivitySummary)

TrueSight Capacity Optimization metric

Description

OEM metric

DISK_IO_RATE

Disk Average I/O Rate aggregated by host

totiosmade

Disk activity (DiskActivity)

Disk activity metrics are not collected if the Alerting and Historical Trending option is not selected in the Use of Metric Data section in the OEM environment. The metrics will be available after 48 hours of enabling this option. 

To enable the Alerting and Historical Trending option
  1. Log on to the Oracle Enterprise Management database as an administrator.
  2. In the OEM interface, from the top navigation bar, click Targets > Hosts
  3. Select the required host from the list of hosts.
  4. From the top-left of the screen, click Host to see the dropdown menu.
  5. Select the Monitoring > Metric and Collection Settings option.
  6. From the Metrics tab, select the Disk Activity metric. 
  7. Click the Collection Schedule link (Example: 15 minutes) corresponding to the the Disk Activity metric.
  8. On the Edit Collection Settings: Disk Activity page, in the Use of Metric Data section, select the Alerting and Historical Trending option. 
  9. Click Continue and then OK to save the changes. 

TrueSight Capacity Optimization metric

Description

OEM metric

BYDISK_UTIL

The percentage of time in which this disk device was busy transferring data during the interval. The subobject specifies the disk name.

DiskActivitybusy

BYDISK_PHYS_IO_RATE

The average number of physical I/O requests per second for this disk. The subobject specifies the disk ID.

DiskActivityreadwrite

BYDISK_SERVICE_TIME

The average service time for I/O requests that were issued to the device.

DiskActivityavserv

BYDISK_QUEUE_TIME

The average time spent by I/O requests into the queue.

DiskActivityavwait

BYDISK_READ_RATE

The average Bytes per second read from this disk device during the interval. The subobject specifies the Disk id.

diskActivReadsBlks

BYDISK_PHYS_IO_READ_RATE

The average number of physical IO read requests per second for this disk

diskActivReadsPerSec

BYDISK_WRITE_RATE

The average Bytes per second written to this disk device during the interval. The subobject specifies the Disk id.

diskActivWritesBlks

BYDISK_PHYS_IO_WRITE_RATE

The average number of physical IO write requests per second for this disk.

diskActivWritesPerSec

File system (Filesystems)

TrueSight Capacity Optimization metric

Description

OEM metric

BYLDISK_USED_SPACE_PCT

The percentage of used disk space specified in the subobject.

pctAvailable

BYLDISK_SIZE

Logical disk size (bytes).

size

Network

TrueSight Capacity Optimization metric

Description

OEM metric

BYIF_IN_BIT_RATE

Input Bit Rate by Network Interface

readRate

BYIF_BIT_RATE

Total BitRate by Network Interface

totalRate

BYIF_PKT_ERR_PCT

Error packets % by Network Interface 

totalErrorRate

BYIF_UTIL

Network Utilization by Network Interface

totalThroughput

BYIF_OUT_BIT_RATE

Output Bit Rate by Network Interface

writeRate

Paging activity (PagingActivity)

TrueSight Capacity Optimization metric

Description

OEM metric

MEM_SWAP_OUT_BYTE_RATE

 The amount of memory that is moved from the swap to real memory per second.

PagingActivityppgout

Host storage history (host_storage_history)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_DATA_FREE_SIZE

Free space available for data files (DB Data Allocated Size - DB Data Used Size).

db_free

DB_DATA_USED_SIZE

Used space for database data files

db_used

DB_TOTAL_FREE_SIZE

The amount of free space the total allocated data can grow on.

total_free

DB_TOTAL_USED_SIZE

The amount of used space within the allocated space

total_used

DB_TOTAL_UNALLOCATED_SIZE

The database space not yet allocated for data, logs and control files

total_unallocated

DISK_USED_SPACE

The total amount of used space on the physical disk, in bytes

disks_allocated

DISK_FREE

The total amount of free space on the physical disk, in bytes.

disks_unallocated

ASM_NUM

Number of Automatic Storage Management

summarized_asm

HOST_NUM

Number of Hosts

summarized_hosts

DB_NUM

Number of Databases

summarized_dbs

TOTAL_FS_USED

Used Disk Space on all filesystems

total_used

Database Server configuration metrics

If the MGMT$HW_CPU_DETAILS view is available in OEM, the following configuration metrics are supported.

TrueSight Capacity Optimization metric

Description

OEM metric

CPU_MODEL

The model of the CPU.

MA

CPU_MHZ

The CPU speed.

FREQ

TOTAL_REAL_MEM

The total real memory that is allocated to the database instance.

MEM

DISK_SIZE

The disk size.

DISK

CPU_NUM

The number of available CPUs.

CPU_COUNT

LCPU_NUM

The number of available logical CPUs.

CPU_COUNT

If the MGMT$HW_CPU_DETAILS view is not available but the MGMT$OS_HW_SUMMARY view is available, the following cofiguration metrics are supported.

TrueSight Capacity Optimization metric

Description

OEM metric

CPU_MODEL

The model of the CPU.

MA

CPU_MHZ

The CPU speed.

FREQ

TOTAL_REAL_MEM

The total real memory that is allocated to the database instance.

MEM

DISK_SIZE

The disk size.

DISK

CPU_NUM

The number of available CPUs.

CPU_COUNT

For the MGMT$TARGET_TYPE_PROPERTIES view, the following metrics are supported:

TrueSight Capacity Optimization metric

Description

OEM metric

OS_TYPE

The type of operation system.

OS

OS_VER

The version of the operating system.

Version

NET_IP_ADDRESS

The IP address.

IP_address

Database Instance (db) metrics

Database Archfull (ArchFull)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_LOG_FREE_SIZE

Free space available for log files (DB Log Allocated Size - DB Log Used Size).

archAvail

DB_LOG_ALLOCATED_SIZE

Allocated space for database log files.

archTotal

DB_LOG_USED_SIZE

Used space for database log files.

archUsed

DB_LOG_USED_SIZE_PCT

Percentage of space used for database log files (DB Log Used Size / DB Log Allocated Size).

archUsedPercent

Database resource usage (Database_Resource_Usage)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_LOGONS_CURRENT

Total number of current logons. Useful only in V$SYSSTAT.

logons

Database instance efficiency (instance_efficiency)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_BUFFER_CACHE_HIT_RATIO

Monitors the rate at which Oracle finds the data blocks it needs in memory over the lifetime of an instance. This monitor indicates the current ratio of buffer cache hits to total requests.

bufcachehit_pct

DB_CPU_TIME_CS

CPU time used by database processes, in centiseconds

cpuusage_ps

DB_CPU_USED

Percentage of database call time that is spent on the CPU.

cpu_time_pct

DB_DICTIONARY_HIT_RATIO

Percentage of times that a procedure execution found the procedure's query plan in procedure cache and available for use.

dictionaryhit_pct

DB_LIBRARY_CACHE_HIT_RATIO

Database library cache hit ratio.

libcache_hit_pct

Database instance throughput (instance_throughput)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_SOFT_PARSE_PCT

Database soft parse percentage.

softparse_pct

DB_COMMIT_RATE

Number of commits per second.

commits_ps

DB_FULL_SCANS_RATE

Rate at which full table scans of long tables occur.

indxscansfull_ps

DB_PHYSICAL_READS

Total number of data blocks read from disk. This number equals the value of physical reads direct plus all reads into buffer cache.

physreads_ps

DB_TRAN_RATE

The number of transactions per second.

transactions_ps

DB_CONSISTENT_CHANGES

Number of times a user process applied rollback entries to perform a consistent read on the block. Workloads that produce a great deal of consistent changes can consume a great deal of resources.

consistentreadchanges_ps

DB_CONSISTENT_GETS

Number of times a consistent read was requested for a block.

consistentreadgets_ps

DB_BLOCK_CHANGES

Closely related to "consistent changes", this statistic counts the total number of changes that were part of an update or delete operation applied to all blocks in the SGA.

dbblkchanges_ps

DB_BLOCK_GETS

Number of times a CURRENT block was requested.

dbblkgets_ps

DB_EXECUTE_COUNT

Total number of calls (user and recursive) that executed SQL statements.

executions_ps

DB_PARSE_COUNT_TOTAL

Total number of parse calls (hard and soft). A soft parse is a check on an object already in the shared pool, to verify that the permissions on the underlying object have not changed.

parses_ps

DB_PHYSICAL_WRITES

Total number of data blocks written to disk. This number equals the value of physical writes direct plus all writes from buffer cache.

physwrites_ps

DB_REDO_WRITES

Total number of writes by LGWR to the redo log files. Redo blocks written divided by this statistic equals the number of blocks per write.

redowrites_ps

DB_SORTS_DISK

Number of sort operations that required at least one disk write. Sorts that require I/O to disk are quite resource-intensive. Try increasing the size of the initialization parameter SORT_AREA_SIZE.

sortsdisk_ps

DB_TABLE_SCANS_LONG_TABLES

Long tables can be defined as tables that do not meet the short table criteria as described in table scans (short tables).

tabscanslong_ps

DB_LOGONS

Total number of logons from the time when the instance started. Useful only in V$SYSSTAT. It gives an instance overview of all processes that logged on.

logons_ps

 DB_USER_CALLS_RATE


usercalls_ps

Dump full (dumpFull)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_DUMP_FREE_SIZE

Free space available for dump area

dumpAvail

DB_DUMP_ALLOCATED_SIZE

Allocated space for dump area

dumpTotal

DB_DUMP_USED_SIZE

Used space for database dump area

dumpUsed

DB_DUMP_USED_SIZE_PCT

Percentage of space used for database dump area

dumpUsedPercent

Database size (DATABASE_SIZE)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_TOTAL_USED_SIZE

Space utilization percentage for the datastore specified in the subobject [DATA]

USED_GB

DB_TOTAL_ALLOCATED_SIZE

Space utilization percentage for the datastore specified in the subobject [DATA]

ALLOCATED_GB

Tablespace allocation (tbspAllocation)

TrueSight Capacity Optimization metric

Description

OEM metric

BYDS_DATA_ALLOCATED_SIZE

Space allocated by the datastore specified in the subobject DATA

spaceAllocated

BYDS_DATA_USED_SIZE

Space used by the datastore specified in the subobject DATA

spaceUsed

Problem table space (problemTbsp)

TrueSight Capacity Optimization metric

Description

OEM metric

BYDS_DATA_USED_SIZE_PCT

Space utilization percentage for the datastore specified in the subobject DATA

pctUsed

System Global Area pool wastage (sga_pool_wastage)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_SGA_SHARED_POOL_FREE_PCT

Oracle SGA Pool Wastage - shared pool free percentage

shared_free_pct

DB_SGA_JAVA_POOL_FREE_PCT

Oracle SGA Pool Wastage - Java pool free percentage

java_free_pct

DB_SGA_LARGE_POOL_FREE_PCT

Oracle SGA Pool Wastage - large pool free percentage

large_free_pct

DB_JAVA_POOL_SIZE

Total size for the Java Pool

Java Pool (MB)

DB_SGA_MAXIMUM_SIZE

Maximum size for the SGA (System Global Area). Oracle specific metric.

Maximum SGA (MB)

DB_SGA_SIZE

Total size for the SGA (System Global Area). Oracle specific metric.

Total SGA (MB)

DB_SGA_FIXED_SIZE

The installed Oracle products and options determine the fixed size, which changes only if the installed products are altered or removed.

Fixed SGA (MB)

DB_SGA_VARIABLE_SIZE

Its value is determined by parameters such as SHARED_POOL_SIZE, PROCESSES, SESSIONS, and TRANSACTIONS at startup. These parameters control the maximum number of user processes, sessions created by users on the system, and transactions allowed on the system at one time.

Variable SGA (MB)

DB_SGA_REDO_BUFFERS

Size of the redo buffer.

Redo Buffers

DB_PGA_SIZE

Size for the PGA (Program Global Area). Oracle specific metric.

pga_aggregate_target

DB_MEMORY_TARGET

The value of the parameter memory_target for an Oracle database instance

memory_target

Database instance configuration metrics

For the MGMT$TARGET_PROPERTIES view, the following metrics are supported:

TrueSight Capacity Optimization metric

Description

OEM metric

DB_HOST_NAME

The host name where the database is installed.

MachineName

DB_PRODUCT_VERSION

The version of the database.

DBVersion

DB_CPU_COUNT

The number of database CPUs.

CPUCount

DB_NAME

The name of the database.

DBName

DB_PRODUCT_NAME

The name of the product.

VersionBanner

Pluggable database instance metrics

Pluggable database instance configuration metrics

TrueSight Capacity Optimization metric

Description

OEM metric

DB_HOST_NAME

The host name where the pluggable database is installed.

MachineName

DB_NAME

The name of the pluggable database.

DBName

DB_PRODUCT_VERSION

The version of the database.

DBVersion

Pluggable database instance performance metrics

TrueSight Capacity Optimization metric

Description

OEM metric

BYDS_DATA_ALLOCATED_SIZE

Space allocated by the datastore specified in the subobject [DATA]

spaceAllocated

BYDS_DATA_USED_SIZE

Space used by the datastore specified in the subobject [DATA]

spaceUsed

Real Application Clusters (rac) metrics

Tablespace allocation (tbspAllocation)

TrueSight Capacity Optimization metric

Description

OEM metric

BYDS_DATA_ALLOCATED_SIZE

Space allocated by the datastore specified in the subobject [DATA]

spaceAllocated

BYDS_DATA_USED_SIZE

Space used by the datastore specified in the subobject [DATA]

spaceUsed

Problem tablespace (problemTbsp)

TrueSight Capacity Optimization metric

Description

OEM metric

BYDS_DATA_USED_SIZE_PCT

Space utilization percentage for the datastore specified in the subobject DATA

pctUsed

Service performance (service_performance)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_CPU_USED

Percentage of CPU used by database processes.

cpuload

Database size (DATABASE_SIZE)

TrueSight Capacity Optimization metric

Description

OEM metric

DB_TOTAL_USED_SIZE

Space utilization percentage for the datastore specified in the subobject [DATA]

USED_GB

DB_TOTAL_ALLOCATED_SIZE

Space utilization percentage for the datastore specified in the subobject [DATA]

ALLOCATED_GB

Metrics for monitored hosts

The following configuration and performance metrics are supported for monitored hosts:

Configuration metrics for monitored hosts

  • BYBENCHMARK_DESCRIPTION
  • BYBENCHMARK_VALUE
  • CPU_FAMILY
  • CPU_MHZ
  • CPU_MODEL
  • CPU_NUM
  • DISK_SIZE
  • LCPU_NUM
  • NET_IP_ADDRESS
  • OS_FAMILY
  • OS_TYPE
  • OS_VER
  • TOTAL_REAL_MEM

Performance metrics for monitored hosts

  • CPU_RUN_QUEUE
  • CPU_UTIL
  • CPU_UTIL_SYSTEM
  • CPU_UTIL_USER
  • CPU_UTIL_WAIO
  • DISK_IO_RATE
  • MEM_ACTIVE
  • MEM_PAGE_SCAN_RATE
  • MEM_REAL_UTIL
  • MEM_SWAP_OUT_BYTE_RATE
  • MEM_UTIL
  • PROCESS_NUM_RUNNING
  • SWAP_SPACE_UTIL

Metrics for Automatic Storage Management (ASM) entities

The following configuration metrics of ASM instances and clusters are supported.

Configuration metrics for ASM instances

TrueSight Capacity Optimization metric

Description

OEM metric

DB_PRODUCT_VERSION

The version of the database.

DBVersion

HOST_NAME

The host name of the virtual machine.

HostName

INSTANCE_ID

The ID of the ASM instance.

InstanceID

ASM_INSTANCE_NAME

The name of the ASM instance.

InstanceName

IS_CLUSTERED_DB

A boolean value that indicates whether the given database is a cluster database.

cluster_database

OS_TYPE

The name of the operating system.

orcl_gtp_os

VERSION

The version of the technology.

Version

Configuration metrics for ASM clusters

TrueSight Capacity Optimization metric

Description

OEM metric

CLUSTER_NAME

The name of the cluster.

ClusterName

DB_PRODUCT_VERSION

The version of the database.

DBVersion

ASM_SERVICE_NAME

The name of the ASM service.

ServiceName

HOST_NAME

The host name of the installed ASM cluster.

MachineName

OS_TYPE

The name of the operating system.

orcl_gtp_os

VERSION

The version of the technology.

VersionCategory

Configuration metrics for ASM disk groups

TrueSight Capacity Optimization metric

Description

OEM metric

DISK_GROUP_NAME

The name of the disk group.

DISK_GROUP

DISK_GROUP_REDUNDANCY

The level of disk group redundancy.

REDUNDANCY

DISK_GROUP_SIZE

The size of the disk group.

TOTAL_SIZE (GB)

DISK_NUM

The number of disks in a disk group.

MEMBER_DISK_COUNT

Performance metrics for ASM disk groups

The following performance metrics for ASM disk groups are supported.

Disk Group Usage (DiskGroup_Usage)

TrueSight Capacity Optimization metric

Description

OEM metric

DISK_GROUP_FREE

The available free space in the disk group in bytes.

free_mb

DISK_GROUP_UTIL

The percentage of space that is used by the disk group.

percent_used


Database Disk Group Usage (Database_DiskGroup_Usage)

TrueSight Capacity Optimization metric

Description

OEM metric

BYDB_DISK_USED

The total size of the used disk per database in bytes.

total_mb


Disk Group Imbalance Status (diskgroup_imbalance)

TrueSight Capacity Optimization metric

Description

OEM metric

DISK_GROUP_IMBALANCE

The percentage of difference between the space that is allocated to the fullest and emptiest disks in the disk group. This imbalance is specified as a percent of full disk size. A large size imbalance indicates the need for a manual rebalancing of the disk group.

imbalance

DISK_GROUP_SIZE_VARIANCE

The percentage of difference between the size of the largest and smallest disks in the disk group. This variance is zero if all the disks are of the same size. A large size variance indicates the need for reconfiguring the disks to evenly distribute the file contents and space across the disks in the disk group.

variance

DISK_GROUP_FREE_IMBALANCE

The percentage of available free space on the fullest disk before the rebalancing of disks. A small value of this imbalance indicates the need to evenly distribute the file contents and space across the disks in the disk group.

computedMinFree

Lookup details

The OEM extractor defines multiple lookup fields. The following table lists the sequence of field set for strong and weak lookup. For more information about entity lookup, see Understanding-entity-identification-and-lookup.

Entity type

Strong lookup fields

Weak lookup fields

Database System (dbs) 

OGUID,HOSTNAME

NAME

Database Instance (db)

OGUID

DB_INSTANCE_NAME&&DB_HOSTNAME

Pluggable Database Instance (pdb)

OGUID

DB_INSTANCE_NAME&&DB_HOSTNAME

Database Cluster (dbc)

OGUID

-

Real Application Clusters (rac)

OGUID

RAC_NAME

ASM Instance (asmi:ora)

OGUID

-

ASM Cluster (asmc:ora)

OGUID

-

ASM Disk Group (asmdg:ora)

OGUID

DISK_GROUP_NAME

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*