Oracle 11g R2性能优化 10046 event

作为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

☆〖本人水平有限，文中如有错误还请留言批评指正！〗☆