DBAtlas · Database operations atlas

Take an AWR snapshot and generate an AWR report between two snapshots

OraclePerformance

Command

-- 1) Manual snapshot before and after the event (run in CDB root):
EXEC DBMS_WORKLOAD_REPOSITORY.CREATE_SNAPSHOT;

-- 2) List snapshots:
SELECT snap_id,
       TO_CHAR(begin_interval_time,'YYYY-MM-DD HH24:MI') AS begin_time,
       TO_CHAR(end_interval_time,'YYYY-MM-DD HH24:MI')   AS end_time
FROM   dba_hist_snapshot
WHERE  dbid = (SELECT dbid FROM v$database)
ORDER  BY snap_id DESC
FETCH FIRST 24 ROWS ONLY;

-- 3a) Interactive report (prompts for HTML/TEXT and snapshot range):
-- @?/rdbms/admin/awrrpt.sql      (RAC: awrgrpt.sql, specific instance: awrrpti.sql)

-- 3b) TEXT report from a script:
SET LINESIZE 8000 PAGESIZE 0 TRIMSPOOL ON HEADING OFF FEEDBACK OFF
SPOOL /tmp/awr_<begin_snap>_<end_snap>.txt
SELECT output
FROM   TABLE(DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_TEXT(
         l_dbid     => (SELECT dbid FROM v$database),
         l_inst_num => (SELECT instance_number FROM v$instance),
         l_bid      => <begin_snap>,
         l_eid      => <end_snap>));
SPOOL OFF
-- For HTML: DBMS_WORKLOAD_REPOSITORY.AWR_REPORT_HTML (same parameters)

What it does

Produces a report between two AWR snapshots covering the problem window: load profile, top wait events, top SQL and instance statistics. The table function lets you pull the report from a script or a scheduler job.

When to use it

When analyzing a slowdown in a specific time window, for before/after comparison around a load test or batch, and for capacity reporting.

Caution

Requires the Diagnostics Pack license (CONTROL_MANAGEMENT_PACK_ACCESS='DIAGNOSTIC' or 'DIAGNOSTIC+TUNING'); without it, set the parameter to 'NONE' and use Statspack. A report cannot span an instance restart. Ranges longer than an hour average out and hide short spikes; keep the window tight.

Open in DBAtlas →

Related