473721 dba feature_usage_statistics

Wie misst Oracle die Verwendung
von Database Features?
Martin Berger
DOAG 2015

Martin Berger
Oracle DBA since 2000
http://berxblog.blogspot.com
@martinberx
martin.a.berger@gmail.com

Disclaimer
this presentation is ONLY about the features and possibilities of
DBA_FEATURE_USAGE_STATISTICS view and supporting
packages/procedures
NO information about LMS activities
NO information about license optimization

DBA_FEATURE_USAGE_STATISTICS
http://docs.oracle.com/database/121/REFRN/GUID-B8A38B9B-3AAA-4341-AA05-
4309870CE73B.htm#REFRN23396

DBID database ID of database being tracked
NAME name of feature
VERSION the database version the feature was tracked in
DETECTED_USAGES number of times the system has detected usage for the feature
TOTAL_SAMPLES number of times the system has woken up and checked for usage
CURRENTLY_USED if usage was detected the last time the system checked
FIRST_USAGE_DATE the first sample time the system detected usage for the feature
LAST_USAGE_DATE the last sample time the system detected usage for the feature
AUX_COUNT extra column to store feature specific usage data
FEATURE_INFO extra column to store feature specific usage data
LAST_SAMPLE_DATE last time the system checked for usage
LAST_SAMPLE_PERIOD amount of time between the last two usage sample times, in number of seconds
SAMPLE_INTERVAL [ 604800 seconds ]
DESCRIPTION describes feature and usage detection logic

components behind the scene
methods to refresh manually
single checks in detail

DBA_FEATURE_USAGE_STATISTICS View:
SELECT samp.dbid, fu.name,
samp.version, detected_usages,
total_samples,
Decode(To_char(last_usage_date, 'MM/DD/YYYY, HH:MI:SS'),
NULL, 'FALSE',
To_char( last_sample_date, 'MM/DD/YYYY, HH:MI:SS'),
'TRUE', 'FALSE')
currently_used,
first_usage_date,
last_usage_date,
aux_count,
feature_info,
last_sample_date,
last_sample_period,
sample_interval,
mt.description
FROM wri$_dbu_usage_sample samp,
wri$_dbu_feature_usage fu,
wri$_dbu_feature_metadata mt
WHERE samp.dbid = fu.dbid
AND samp.version = fu.version
AND fu.name = mt.name
AND fu.name NOT LIKE '_DBFUS_TEST%'
/* filter out test features */
AND Bitand(mt.usg_det_method, 4) != 4
/* filter out disabled features */

DETECTED_USAGES number of times the system has detected usage for th
TOTAL_SAMPLES number of times the system has woken up and checked
CURRENTLY_USED if usage was detected the last time the system check
FIRST_USAGE_DATE the first sample time the system detected usage for
LAST_USAGE_DATE the last sample time the system detected usage for t
LAST_SAMPLE_PERIOD amount of time between the last two usage sample tim
wri$_dbu_usage_sample samp
*DBID
*VERSION
*LAST_SAMPLE_DATE
LAST_SAMPLE_DATE_NUM
*LAST_SAMPLE_PERIOD
*TOTAL_SAMPLES
*SAMPLE_INTERVAL

wri$_dbu_feature_usage fu
DBID
*NAME
VERSION
*FIRST_USAGE_DATE
*LAST_USAGE_DATE
*DETECTED_USAGES
*AUX_COUNT
*FEATURE_INFO
ERROR_COUNT

NAME
INST_CHK_METHOD
INST_CHK_LOGIC
USG_DET_METHOD
USG_DET_LOGIC
*DESCRIPTION

Decode(
To_char(last_usage_date,
'MM/DD/YYYY, HH:MI:SS'),
NULL, 'FALSE',
To_char( last_sample_date,
'MM/DD/YYYY, HH:MI:SS'),
'TRUE', 'FALSE')

WHERE samp.dbid = fu.dbid
AND samp.version = fu.version
AND fu.name = mt.name
AND fu.name NOT LIKE '_DBFUS_TEST%'
/* filter out test features */
AND Bitand(mt.usg_det_method, 4) != 4
/* filter out disabled features */

wri$_dbu_feature_usage wri$_dbu_feature_metadata wri$_dbu_usage_sample

DBMS_FEATURE_USAGEDBMS_FEATURE_USAGE_INTERNALDBMS_FEATURE_*

DBMS_FEATURE_USAGEDBMS_FEATURE_USAGE_INTERNALDBMS_FEATURE_*
DBMS_SWRF_REPORT_INTERNAL

alter session set events 'immediate trace name mmon_test level 6';
How to Manually Refresh Dba_feature_usage_statistics (Doc ID 1629485.1)

alter session set "_SWRF_TEST_ACTION"=53;

SWR => Select Workload Repository (Framework?)
ADR auto purge
alter session set "_swrf_test_action" = 101;
Bug 9530322 ADR auto purge does not occur in ASM instance or standby database
Split the AWR partitions
alter session set "_swrf_test_action" = 72;
Manually Purge the Optimizer Statistics & AWR Snaphots to Reduce Space Usage of SYSAUX Tablespace (Doc ID 1965061.1)
AWR Snapshot traces
snapshot flush trace enable 10 disable
11
MMON action trace enable 28 disable
29
other "_SWRF_TEST_ACTION" values

alter session set "_SWRF_TEST_ACTION"=53;
DEMO

to check, if the feature is installed at all:
DBU_INST_ALWAYS_INSTALLED 1 /* no test required
*/
DBU_INST_OBJECT 2 /* object
name in LOGIC */
DBU_INST_TEST 4 /* only
test */
NAME
INST_CHK_METHOD
INST_CHK_LOGIC
USG_DET_METHOD
USG_DET_LOGIC
*DESCRIPTION

DBU_INST_ALWAYS_INSTALLED 1 /* no test required */
name in LOGIC */
DBU_INST_TEST 4 /* only test
*/
method to be used to check feature usage::
DBU_DETECT_BY_SQL 1 /* SQL
specified in USG_DET_LOGIC */
DBU_DETECT_BY_PROCEDURE 2 /* Procedure -- “
-- */
DBU_DETECT_NULL 4 /* only test
for _DBFUS_TEST_SQL_7 */
NAME
INST_CHK_METHOD
INST_CHK_LOGIC
USG_DET_METHOD
USG_DET_LOGIC
*DESCRIPTION
$ORACLE_HOME/rdbms/admin/catfusrg.sql -> dbmsfus.sql -> prvtfus.plb

DBU_INST_ALWAYS_INSTALLED 1 /* no test required */
name in LOGIC */
DBU_INST_TEST 4 /* only test
*/
method to be used to check feature usage::
DBU_DETECT_BY_SQL 1 /* SQL
specified in USG_DET_LOGIC */
DBU_DETECT_BY_PROCEDURE 2 /* Procedure -- “
-- */
DBU_DETECT_NULL 4 /* only test
for _DBFUS_TEST_SQL_7 */
examples:
Advanced Replication: select count(*), NULL, NULL from dba_repcat;
Zone maps: DBMS_FEATURE_ZMAP
Oracle Text: ctxsys.drifeat.dr$feature_track
NAME
INST_CHK_METHOD
INST_CHK_LOGIC
USG_DET_METHOD
USG_DET_LOGIC
*DESCRIPTION

DBMS_FEATURE_*
Argument Name Type In/Out Default
------------- ------ ------ -------
IS_USED NUMBER OUT
DATA_RATIO NUMBER OUT
CLOB_REST CLOB OUT
NAME
INST_CHK_METHOD
INST_CHK_LOGIC
USG_DET_METHOD
USG_DET_LOGIC
*DESCRIPTION

DBMS_FEATURE_*
Argument Name Type In/Out Default
------------- ------ ------ -------
IS_USED NUMBER OUT
DATA_RATIO NUMBER OUT
CLOB_REST CLOB OUT
NAME
INST_CHK_METHOD
INST_CHK_LOGIC
USG_DET_METHOD
USG_DET_LOGIC
*DESCRIPTION
DEMO

create or replace PROCEDURE dbms_feature_goldengate
(feature_boolean OUT NUMBER, aux_count OUT NUMBER, feature_info
OUT CLOB)
…...
select decode (count(*), 0, 0, 1) into num_capture
from dba_capture where UPPER(purpose) = 'GOLDENGATE CAPTURE';
select decode (count(*), 0, 0, 1) into num_ds_capture from dba_capture
where UPPER(purpose) = 'GOLDENGATE CAPTURE' and UPPER(capture_type) = 'DOWNSTREAM';
select decode (count(*), 0, 0, 1) into num_apply from dba_apply
where UPPER(purpose) IN ('GOLDENGATE APPLY', 'GOLDENGATE CAPTURE');
select sum(count) into num_dblogreader
from GV$GOLDENGATE_CAPABILITIES where name like 'DBLOGREADER';
select sum(count) into num_transient_duplicate
from GV$GOLDENGATE_CAPABILITIES where name like 'TRANSIENTDUPLICATE';
select sum(count) into num_trigger_suppression

report
Database Options/Management Packs Usage Reporting for Oracle Databases 11gR2 and 12c (Doc ID
1317265.1)
PRODUCT USAGE
Description
This section provides an overview of each option/pack that has been used in the database and if they are
currently in use. It will also provide information when the product was first used and when it was used last time.
FEATURE USAGE DETAILS
Description
This section provides a detailed report of features used that has triggered the usage of a product.
The report is based on the DBA_FEATURE_USAGE_STATISTICS view.
The CURRENTLY_USED column of DBA_FEATURE_USAGE_STATISTICS view indicates if the feature in question
was used during the last sampling interval by VERSION and DBID
SQL> @options_packs_usage_statistics.sql

Disclaimer (again)
this presentation is ONLY about the features and possibilities of
DBA_FEATURE_USAGE_STATISTICS view and supporting
packages/procedures
NO information about LMS activities
NO information about license optimization

Wie misst Oracle die Verwendung
von Database Features?
DOAG 2015
http://berxblog.blogspot.com
@martinberx
martin.a.berger@gmail.com

473721 dba feature_usage_statistics

In this document