正文 作為SQL Trace的擴展功能,Oracle 10046 event(10046事件)是一個重要的調試事件,也可以說是系統性能分析時最重要的一個事件,它包含比SQL Trace更多的信息。但可惜的是,10046事件並不是Oracle官方提供給用戶的診斷工具,官方文檔上面也沒有詳細的說明,不過 ...
正文
作為SQL Trace的擴展功能,Oracle 10046 event(10046事件)是一個重要的調試事件,也可以說是系統性能分析時最重要的一個事件,它包含比SQL Trace更多的信息。但可惜的是,10046事件並不是Oracle官方提供給用戶的診斷工具,官方文檔上面也沒有詳細的說明,不過還是可以從很多國內外專家技術文檔找到相關學習資料,本文主要參考Oracle MOS文檔來學習總結下10046事件的用法。
關於SQL Trace的收集方式可以參考另一篇博文:Oracle 11g R2性能優化 SQL TRACE
關於10046 event trace的收集方式可以參考Oracle MOS文檔:How To Collect 10046 Trace (SQL_TRACE) Diagnostics for Performance Issues (文檔 ID 376442.1)
主要說明
10046 event根據跟蹤的信息詳細程度可以分成不同的等級,高級別向低級別相容,即級別高的跟蹤信息包含級別低的信息。
主要級別說明如下表所示:
級別(Level) | 說明(Description) |
---|---|
0 | 不生成跟蹤統計信息,相當於SQL_TRACE=FALSE |
1 | 生成標準跟蹤統計信息,相當於SQL_TRACE=TRUE,為預設級別 |
2 | 與級別1相同 |
4 | 級別1基礎上 + 綁定變數跟蹤 |
8 | 級別1基礎上 + 等待事件跟蹤 |
12 | 級別4 + 級別8 |
16 | 級別1基礎上 + 每次執行時寫入執行計劃信息(11g新增) |
通常使用的級別為12,10046 event跟蹤信息可以基本滿足分析的需求。關於級別的詳細說明可以參考國外大神Christian Antognini的博文:Event 10046 – Full List of Levels
常用使用方式
會話級別開啟
根據參考的MOS文檔描述,會話級別開啟10046 event跟蹤之前需設置幾個會話級參數選項,如下:
tracefile_identifier
設置生成trace文件的標識符。statistics_level
指定資料庫和操作系統統計信息的收集級別,取值為{typical|all|basic}。timed_statistics
指定是否收集與時間相關的統計信息,當statistics_level參數值為typical或all時預設值為true,當statistics_level參數值為basic時預設值為false。max_dump_file_size
指定trace文件(包括告警文件)的最大值,預設為unlimited,取值為{integer [K|M|G] | unlimited}。
會話級別參數設置:
SCOTT@dbabd> alter session set tracefile_identifier = '10046_SCOTT';
Session altered.
SCOTT@dbabd> alter session set timed_statistics = true;
Session altered.
SCOTT@dbabd> alter session set statistics_level = all;
Session altered.
SCOTT@dbabd> alter session set max_dump_file_size = unlimited;
Session altered.
- 開啟10046 event跟蹤:
-- 這裡開啟級別為12
SCOTT@dbabd> alter session set events '10046 trace name context forever,level 12';
Session altered.
- 執行需要跟蹤語句:
-- 以查詢scott.dept表為例
SCOTT@dbabd> select * from dept;
DEPTNO DNAME LOC
---------- ------------------------------------------ ---------------------------------------
10 ACCOUNTING NEW YORK
20 RESEARCH DALLAS
30 SALES CHICAGO
40 OPERATIONS BOSTON
- 關閉10046 event跟蹤:
SCOTT@dbabd> alter session set events '10046 trace name context off';
Session altered.
或
SCOTT@dbabd> exit;
ORADEBUG開啟
oradebug是一個SQL*PLUS命令行工具,它可以跟蹤會話、dump記憶體結構、喚醒進程等。同時,oradebug也可以用來開啟10046事件跟蹤,並且它可以直接顯示trace文件的路徑,想要使用oradebug需要有sysdba許可權。
關於oradebug詳細說明可以參考:ORADEBUG introduction
在oradebug工作之前,必須確定連接的進程號,oradebug主要有如下連接進程方式:
SETMYPID Debug current process -- 跟蹤當前會話進程
SETOSPID <ospid> Set OS pid of process to debug -- 通過操作系統的進程
SETORAPID <orapid> ['force'] Set Oracle pid of process to debug -- 通過Oracle的進程
如果無法獲取OS pid或者Oracle pid,可以通過如下腳本獲取:
- 獲取OS pid和會話id(session id)
-- 腳本
column line format a80
set heading off
select 'ospid: ' || p.spid || ' # ''' || s.sid || ',' || s.serial# || ''' ' ||
s.osuser || ' ' || s.machine || ' ' || s.username || ' ' ||
s.program line
from v$session s, v$process p
where p.addr = s.paddr
and s.username <> ' ';
-- 輸出
SYS@dbabd> column line format a80
SYS@dbabd> set heading off
SYS@dbabd> select 'ospid: ' || p.spid || ' # ''' || s.sid || ',' || s.serial# || ''' ' ||
2 s.osuser || ' ' || s.machine || ' ' || s.username || ' ' ||
3 s.program line
4 from v$session s, v$process p
5 where p.addr = s.paddr
6 and s.username <> ' ';
ospid: 24561 # '12,29' oracle dbabd SYS sqlplus@dbabd (TNS V1-V3)
ospid: 9769 # '138,365' oracle dbabd SCOTT sqlplus@dbabd (TNS V1-V3)
ospid: 24668 # '18,9' oracle dbabd SYS sqlplus@dbabd (TNS V1-V3)
一般通過操作系統進程就可以確定跟蹤會話,也可以通過Oracle pid來跟蹤。通過以上腳本也可以獲取到會話id(session id),這裡以SCOTT用戶為例,SCOTT用戶的sid為138。
- 獲取Oracle pid
-- 腳本
select p.PID, p.SPID, s.SID
from v$process p, v$session s
where s.paddr = p.addr
and s.sid = &SESSION_ID; -- 輸入上述腳本得到的sid,如138
-- 輸出
SYS@dbabd> select p.PID, p.SPID, s.SID
2 from v$process p, v$session s
3 where s.paddr = p.addr
4 and s.sid = &SESSION_ID;
Enter value for session_id: 138
old 4: and s.sid = &SESSION_ID
new 4: and s.sid = 138
25 9769 138
- 確定oradebug連接進程
SYS@dbabd> oradebug setospid 9769
Oracle pid: 25, Unix process pid: 9769, image: oracle@dbabd (TNS V1-V3)
或
SYS@dbabd> oradebug setorapid 25
Oracle pid: 25, Unix process pid: 9769, image: oracle@dbabd (TNS V1-V3)
- 配置trace文件的標識符
SYS@dbabd> oradebug settracefileid 10046_SCOTT_ORADEBUG;
Statement processed.
- 開啟10046 event跟蹤
SYS@dbabd> oradebug event 10046 trace name context forever, level 12;
Statement processed.
- SCOTT用戶模擬執行語句
SCOTT@dbabd> select * from dept;
DEPTNO DNAME LOC
---------- ------------------------------------------ ---------------------------------------
10 ACCOUNTING NEW YORK
20 RESEARCH DALLAS
30 SALES CHICAGO
40 OPERATIONS BOSTON
- 關閉10046 event跟蹤
SYS@dbabd> oradebug event 10046 trace name context off;
Statement processed.
- 關閉trace文件
SYS@dbabd> oradebug close_trace;
Statement processed.
- 查詢當前trace文件路徑
SYS@dbabd> oradebug tracefile_name;
/data/app/oracle/diag/rdbms/dbabd/dbabd/trace/dbabd_ora_9769_10046_SCOTT_ORADEBUG.trc
DBMS_SYSTEM包開啟
通過DBMS_SYSTEM包也可以開啟10046 event跟蹤,主要是包中存儲過程SET_EV來完成,查看存儲過程所需的參數選項:
PROCEDURE SET_EV
Argument Name Type In/Out Default?
------------------------------ ----------------------- ------ --------
SI BINARY_INTEGER IN -- SID
SE BINARY_INTEGER IN -- SERIAL#
EV BINARY_INTEGER IN -- 事件代碼,如10046
LE BINARY_INTEGER IN -- 事件級別,如12
NM VARCHAR2 IN
通過以上參數選項分析,採用DBMS_SYSTEM包的方式最少需要獲取SID,獲取SID可以參考oradebug當中的腳本,這裡不再重覆說明,為了方便查找trace文件,也可以事先配置trace文件的標識符,還是以SCOTT用戶為例,trace文件標識符為10046_SCOTT_DBMSSYSTEM。
- 配置trace文件標識符
SYS@dbabd> oradebug setospid 9769
Statement processed.
SYS@dbabd> oradebug settracefileid 10046_SCOTT_DBMSSYSTEM;
Statement processed.
- 開啟10046 event跟蹤:
SYS@dbabd> exec dbms_system.set_ev(138,365,10046,12,'');
PL/SQL procedure successfully completed.
- 關閉10046 event跟蹤:
SYS@dbabd> exec dbms_system.set_ev(138,365,10046,0,'');
PL/SQL procedure successfully completed.
或
SYS@dbabd> exec dbms_system.set_sql_trace_in_session(138,365,false);
PL/SQL procedure successfully completed.
DBMS_MONITOR包開啟
DBMS_MONITOR包也可以開啟10046 event跟蹤,通地包中存儲過程SESSION_TRACE_ENABLE來完成。從本文前面部分的說明也可以瞭解到,級別為12的10046 event跟蹤就是包含綁定變數與等待事件信息。關於存儲過程SESSION_TRACE_ENABLE選項說明可以參考另一篇博文:DBMS_MONITOR包跟蹤,這裡以SCOTT用戶為例,trace文件標識符為10046_SCOTT_DBMSMONITOR。
- 配置trace文件標識符
SYS@dbabd> oradebug setospid 9769
Statement processed.
SYS@dbabd> oradebug settracefileid 10046_SCOTT_DBMSMONITOR;
Statement processed.
- 開啟10046 event跟蹤
SYS@dbabd> exec dbms_monitor.session_trace_enable(138,365,true,true,'all_executions');
PL/SQL procedure successfully completed.
- 關閉10046 event跟蹤
SYS@dbabd> exec dbms_monitor.session_trace_disable(138,365);
PL/SQL procedure successfully completed.
DBMS_SUPPORT包開啟
還有一個DBMS_SUPPORT包可以開啟10046 event跟蹤。不過這個包的說明在官方文檔中沒有找到,預設沒有安裝,可以通過查看Oracle MOS文檔安裝:How to Install the DBMS_SUPPORT Package (文檔 ID 377204.1),關於包的說明也可以參考文檔:The DBMS_SUPPORT Package (文檔 ID 62294.1)。這裡以SCOTT用戶為例,trace文件標識符為10046_SCOTT_DBMSSUPPORT。
- 查看DBMS_SUPPORT包信息
SYS@dbabd> desc dbms_support;
ERROR:
ORA-04043: object dbms_support does not exist
預設沒有安裝,提示未找到。
- 安裝DBMS_SUPPORT包
SYS@dbabd> @?/rdbms/admin/dbmssupp.sql
Package created.
Package body created.
SYS@dbabd> grant execute on dbms_support to schema_owner; -- 授權執行許可權給需要用戶,如SCOTT
SYS@dbabd> create public synonym dbms_support for dbms_support; -- 創建同名的同義詞
Synonym created.
- 查看DBMS_SUPPORT包
SYS@dbabd> desc dbms_support;
FUNCTION MYSID RETURNS NUMBER -- 查詢當前會話的SID
FUNCTION PACKAGE_VERSION RETURNS VARCHAR2 -- 查詢包版本
PROCEDURE START_TRACE -- 開啟當前會話跟蹤
Argument Name Type In/Out Default?
------------------------------ ----------------------- ------ --------
WAITS BOOLEAN IN DEFAULT
BINDS BOOLEAN IN DEFAULT
PROCEDURE START_TRACE_IN_SESSION -- 開啟其他會話跟蹤
Argument Name Type In/Out Default?
------------------------------ ----------------------- ------ --------
SID NUMBER IN -- 對應SID
SERIAL NUMBER IN -- 對應SERIAL#
WAITS BOOLEAN IN DEFAULT -- 對應是否加入等待事件跟蹤
BINDS BOOLEAN IN DEFAULT -- 對應是否加入綁定變數跟蹤
PROCEDURE STOP_TRACE -- 關閉當前會話跟蹤
PROCEDURE STOP_TRACE_IN_SESSION -- 關閉其他會話跟蹤
Argument Name Type In/Out Default?
------------------------------ ----------------------- ------ --------
SID NUMBER IN
SERIAL NUMBER IN
-- 查詢當前會話的SID
SYS@dbabd> select dbms_support.mysid from dual;
MYSID
----------
12
-- 查詢包版本
SYS@dbabd> select dbms_support.package_version from dual;
PACKAGE_VERSION
--------------------------------------------------------------------------------
DBMS_SUPPORT Version 1.0 (17-Aug-1998) - Requires Oracle 7.2 - 8.0.5
- 配置trace文件標識符
SYS@dbabd> oradebug setospid 9769
Statement processed.
SYS@dbabd> oradebug settracefileid 10046_SCOTT_DBMSSUPPORT;
Statement processed.
- 開啟10046 event跟蹤
SYS@dbabd> exec dbms_support.start_trace_in_session(138,365,true,true);
PL/SQL procedure successfully completed.
- 關閉10046 event跟蹤
SYS@dbabd> exec dbms_support.stop_trace_in_session(138,365);
PL/SQL procedure successfully completed.
資料庫級別開啟
10046 event跟蹤也可以在資料庫級別開啟,但通常很少會這樣用,因為會導致所有會話都被跟蹤而影響整體性能。當動態開啟整個資料庫的跟蹤時,會對之後創建的每個會話進行跟蹤,而已經存在的會話不會被跟蹤。
資料庫級別的10046 event跟蹤通常用於當提前知道會話會出現性能問題,但卻無法明確具體是哪個會話時。
當問題會話被定位以及跟蹤之後,確認收集了相關的跟蹤信息就可以將資料庫級別的跟蹤進行關閉,因為這會影響系統整體的性能。開啟資料庫級別跟蹤的用戶需要有sysdba的許可權,動態開啟可以使用以下方式:
- 語句開啟10046 event跟蹤
SYS@dbabd> alter system set events '10046 trace name context forever,level 12';
System altered.
- 語句關閉10046 event跟蹤
alter system set events '10046 trace name context off';
System altered.
DBMS_MONITOR包也可以開啟資料庫級別的10046 event跟蹤,主要由DATABASE_TRACE_DISABLE和DATABASE_TRACE_ENABLE存儲過程來完成。關於這兩個存儲過程的參數選項說明如下:
PROCEDURE DATABASE_TRACE_ENABLE -- 開啟
Argument Name Type In/Out Default?
------------------------------ ----------------------- ------ --------
WAITS BOOLEAN IN DEFAULT -- 對應是否加入等待事件跟蹤
BINDS BOOLEAN IN DEFAULT -- 對應是否加入綁定變數跟蹤
INSTANCE_NAME VARCHAR2 IN DEFAULT -- 實例名,如dbabd
PLAN_STAT VARCHAR2 IN DEFAULT
PROCEDURE DATABASE_TRACE_DISABLE -- 關閉
Argument Name Type In/Out Default?
------------------------------ ----------------------- ------ --------
INSTANCE_NAME VARCHAR2 IN DEFAULT -- 實例名,如dbabd
- DBMS_MONITOR包開啟10046 event跟蹤
SYS@dbabd> exec dbms_monitor.database_trace_enable(true,true,'dbabd','all_executions');
PL/SQL procedure successfully completed.
- DBMS_MONITOR包關閉10046 event跟蹤
SYS@dbabd> exec dbms_monitor.database_trace_disable('dbabd');
PL/SQL procedure successfully completed.
總結
以上總結了主要的幾種開啟10046 event跟蹤的方法,但還是有很多方面並未涉及,包括多會話跟蹤、指定sql_id過濾跟蹤等,這些跟蹤涉及得更為細緻,對於具體問題的分析更為有效,日後也會進行總結梳理。對於10046 event產生的trace文件,同樣也可以通過tkprof工具進行格式化後增加可閱讀性,關於tkprof工具的主要使用方式也可參考另一篇博文:Oracle 11g R2性能優化 tkprof
參考
How To Collect 10046 Trace (SQL_TRACE) Diagnostics for Performance Issues (文檔 ID 376442.1)
The DBMS_SUPPORT Package (文檔 ID 62294.1)
Oracle TKPROF & SQL_TRACE
https://antognini.ch/2012/08/event-10046-full-list-of-levels/
http://www.juliandyke.com/Diagnostics/Tools/ORADEBUG/ORADEBUG.php
https://www.cnblogs.com/youngerger/p/8541885.html
https://oracle-base.com/articles/misc/sql-trace-10046-trcsess-and-tkprof
☆〖本人水平有限,文中如有錯誤還請留言批評指正!〗☆