Merge pull request #401 from oracle-devrel/uschwinn-performance

Uschwinn performance

Author: JesusGitHubOracle

data-platform/core-converged-db/db-performance/README.md

@@ -0,0 +1,44 @@
+# Database Performance
+
+
+Effective data collection and analysis is essential for identifying and correcting performance problems. Oracle Database provides several tools that allow a performance engineer to gather information regarding database performance. In addition to gathering data, Oracle Database provides tools to monitor performance, diagnose problems, and tune applications. 
+They are usually available through different methods: Graphical tools such as Oracle Enterprise Manager Cloud Control, SQL Developer, Oracle scripts, PL/SQL packages, initialization parameters or through corresponding v$ views. Most of them are available without additional installation and can be used immediately. Others can be loaded separately from My Oracle Support (MOS) or can be activated and used via Cloud Console. 
+
+Examples are:
+- Automatic Workload Repository (AWR) collects, processes, and maintains performance statistics for problem detection and self-tuning purposes. 
+- Automatic Database Diagnostic Monitor (ADDM) analyzes the information collected by AWR for possible performance problems with the Oracle database. 
+- SQL Tuning Advisor allows a quick and efficient technique for optimizing SQL statements without modifying any statements.
+- SQL Access Advisor provides advice on materialized views, indexes, and materialized view logs.
+- SQL Performance Analyzer as part of Real Application Testing assesses the impact of system changes on the response time of SQL statements. 
+- Real-time SQL Monitoring gives an up-to-date overview of operations and displays statements that are currently active or in a queue.
+- Explain Plan displays execution plans chosen by the optimizer.
+- Special Performance pages (aka Performance Hub) in Cloud Control or OCI Console and associated reports deliver a consolidated view of all performance data for 
+  and provide summary information not only on overall IO, CPU and Memory usage by the database but also detailed SQL monitoring information.
+
+
+## Useful Links
+
+### Documentation
+
+- [Oracle Database 19c Performance](https://docs.oracle.com/en/database/oracle/oracle-database/19/performance.html)
+- [PL/SQL Packages and Types Reference DBMS_PERF](https://docs.oracle.com/en/database/oracle/oracle-database/19/arpls/DBMS_PERF.html#GUID-290C18B9-A2EF-468D-9D6E-B31D717082BB)
+- [Oracle Cloud Infrastructure Documentation - Performance Hub Report](https://docs.oracle.com/en-us/iaas/autonomous-database/doc/use-perf-hub-monitor-databases.html)
+
+
+### Team Publications
+
+- [Performance Hub - the database tuning gem](https://blogs.oracle.com/coretec/post/oracle-performance-hub)
+- [Real-time SQL Monitoring on github](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/core-converged-db/sql-performance/sql-monitoring)
+- [SQL Performance Analyzer on github](https://github.com/oracle-devrel/technology-engineering/tree/main/data-platform/core-converged-db/real-application-testing/sql-performance-analyzer)
+
+### Blogs and technical briefs
+- [Monitoring Database Performance Using Performance Hub Report (Doc ID 2436566.1)](https://support.oracle.com/epmos/faces/SearchDocDisplay?_afrLoop=459842075147901&_afrWindowMode=0&_adf.ctrl-state=p9nyc4tf7_4)
+- [The performance report you are NOT using](https://connor-mcdonald.com/2021/04/30/the-performance-report-you-are-not-using/)
+
+# License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See LICENSE for more details.

data-platform/core-converged-db/db-performance/performancehub/README.md

@@ -0,0 +1,23 @@
+# Performance Hub
+This folder provides SQL scripts to generate active Performance Hub reports. The Oracle provided script perfhubrpt.sql and the PL/SQL package DBMS_PERF especially REPORT_PERFHUB will be used.
+Information on the script usage can also be found in the blog posting [Performance Hub - the database tuning gem](https://blogs.oracle.com/coretec/post/oracle-performance-hub).
+
+
+Please refer to the [DBMS_PERF documentation](https://docs.oracle.com/en/database/oracle/oracle-database/21/arpls/DBMS_PERF.html#GUID-85CD8AB9-B6E0-444F-91A5-762EB92A74E9) to get detailled information on the parameters which can be used.
+
+Before you start make sure that the user has DBA privileges.
+
+### Performance Hub scripts
+
+-  perfhubscript.sql: Use the Oracle provided script perfhubrpt.sql
+-  dbmsperf_def.sql: Example for DBMS_PERF.REPORT_PERFHUB with default settings
+-  dbmsperf_1.sql: Example for DBMS_PERF.REPORT_PERFHUB with parameters
+
+
+  # License
+
+Copyright (c) 2023 Oracle and/or its affiliates.
+
+Licensed under the Universal Permissive License (UPL), Version 1.0.
+
+See LICENSE for more details.

data-platform/core-converged-db/db-performance/performancehub/dbmsperf_1.sql

@@ -0,0 +1,23 @@
+REM  Script: dbmsperf_1.sql
+REM  example for DBMS_PERF.REPORT_PERFHUB with parameters
+ 
+REM REPORT_PERFHUB generates an active performance report of the entire database system for a specified time period.
+REM Arguments in this example define the report mode (historical or real-time) and start and end time for the time selection and outer time.
+REM Different tabs are available in the Performance Hub, depending on whether is_real-time is 1 for real-time mode or 0 for historical mode.
+REM When real-time data is selected, more granular data is presented because data points are available every minute.
+REM If historical data is chosen, more detailed data is presented, but the data points are averaged out to the AWR interval (usually an hour). 
+
+
+set pages 0 linesize 32767 trimspool on trim on long 1000000 longchunksize 10000000
+
+spool sql_details_1.html
+
+select dbms_perf.report_perfhub (
+is_realtime         => &realtime,  
+outer_start_time    => to_date('&outerstart','dd-MON-YYYY hh24:mi:ss'), 
+outer_end_time      => to_date('&outerend','dd-MON-YYYY hh24:mi:ss'), 
+selected_start_time => to_date('&starttime','dd-MON-YYYY hh24:mi:ss'), 
+selected_end_time   => to_date('&endtime','dd-MON-YYYY hh24:mi:ss')) 
+from dual; 
+
+spool off

data-platform/core-converged-db/db-performance/performancehub/dbmsperf_def.sql

@@ -0,0 +1,14 @@
+REM  Script: dbmsperf_def.sql
+REM  example for DBMS_PERF.REPORT_PERFHUB with defaults 
+REM REPORT_PERFHUB generates an active performance report of the entire database system for a specified time period.
+REM If you choose the defaults, report mode is historical, selected time is 1 hour before latest AWR and outer time period starts 24 hours before. 
+
+
+set pages 0 linesize 32767 trimspool on trim on long 1000000 longchunksize 10000000
+
+spool sql_details_def.html
+
+select dbms_perf.report_perfhub() 
+from dual; 
+
+spool off

data-platform/core-converged-db/db-performance/performancehub/perfhubscript.sql

@@ -0,0 +1,10 @@
+REM  Script: perfhubscript.sql
+REM  Oracle script perfhubrpt.sql
+REM The Performance Hub Report can be generated in Single-Instance Database, in RAC and for PDBs and root containers.
+
+REM Connect with DBA privileges
+REM Start the perfhubrpt.sql from $ORACLE_HOME/rdbms/admin
+REM You will be prompted for report level (basic, typical or all), database id, instance id and time range. 
+REM An active  HTML report will be generated in the dirctory 
+
+@?/rdbms/admin/perfhubrpt.sql