LLI Wiki — My Digital Knowledge Base

Oracle : activer, désactiver et lister les événements avec oradebug

Activer et désactiver des événements Oracle, lister les événements actifs avec oradebug eventdump, et sélection de codes d'événements courants.

Les événements Oracle (events) permettent d'activer des traces de diagnostic ou de modifier le comportement de l'instance. Cet article montre comment les activer, les désactiver, lister ceux qui sont actifs avec oradebug, et donne une sélection de codes d'événements courants.

Activer un événement

alter system set events '1017 trace name errorstack level 10';
alter system set events '942 trace name errorstack level 3';

Désactiver un événement

alter system set event="10852 trace name context off" scope=spfile;
alter system set events '1652 trace name errorstack off';
alter system set events '1017 trace name errorstack off';

Lister les événements actifs

La commande oradebug eventdump affiche les événements activés pour un groupe donné :

Groupe Contenu
session Événements du groupe session
process Événements du groupe processus
system Événements du groupe système (événements valables pour toute l'instance)
SQL> oradebug eventdump [level]

oradebug eventdump session
oradebug eventdump process
oradebug eventdump system

Événements d'une session d'un autre utilisateur

Identifier le processus de la session (ici l'utilisateur SCOTT) :

set linesize 300
column pid format 99999
column spid format 99999
column username format a50
select p.pid, p.spid, s.username
from v$process p, v$session s
where p.addr = s.paddr;
   PID   SPID USERNAME
 ----- ------ ---------
    15  28390 SCOTT

Se rattacher à cette session avec oradebug, par l'identifiant Oracle du processus ou par celui du système d'exploitation :

SQL> connect / as sysdba
SQL> oradebug setorapid 15
--OU--
SQL> oradebug setospid 28390

oradebug tracefile_name

Puis lire les événements actifs de la session :

SQL> oradebug eventdump session
942 trace name ERRORSTACK level 3

Événements de la session courante

SQL> alter session set events '942 trace name errorstack level 3';
Session altered.
SQL> oradebug tracefile_name
/oracle/admin/ORCL/udump/orcl_ora_32493.trc

Erreur ORA-00074

Si oradebug eventdump session renvoie ORA-00074: no process has been specified, il faut d'abord désigner le processus courant :

SQL> oradebug setmypid
Statement processed.
SQL> oradebug eventdump session;
3171 trace name errorstack level 3

Sélection de codes d'événements

Ces codes proviennent de listes d'événements internes, en grande partie non documentés officiellement. Ils sont à utiliser avec prudence, de préférence sur une base de test.

Code Description
10005 Trace des opérations sur les latches
10015 Récupération de segment d'annulation (undo)
10029 Ouverture de session (KSU)
10030 Fermeture de session (KSU)
10035 Analyse d'une instruction SQL (OPIPRS)
10046 Activer le chronométrage des instructions SQL
10049 Protection de la mémoire du library cache
10053 CBO : activer la trace de l'optimiseur
10060 CBO : activer le dump des prédicats
10092 CBO : désactiver la jointure par hachage (hash join)
10093 CBO : forcer les jointures par hachage
10104 Écrire les statistiques de hash join dans le fichier de trace
10120 CBO : désactiver l'index fast full scan
10200 Block cleanout
10201 Application de l'undo pour la lecture cohérente
10210 Vérifier l'intégrité des blocs de données
10211 Vérifier l'intégrité des blocs d'index
10231 Ignorer les blocs corrompus lors des parcours de table
10233 Ignorer les blocs corrompus lors des opérations sur index
10246 Écrire dans la trace les actions de PMON
10270 Débogage des curseurs partagés
10289 Dumps de blocs en hexadécimal plutôt que formatés
10352 Statistiques de chemin direct (direct path)
10390 Trace de l'exécution des esclaves de requête parallèle
10393 Afficher les statistiques de requête parallèle
10400 Dumps d'état du système pour le débogage d'un arrêt
10500 Activer les traces de SMON
10704 Afficher les enqueues obtenues
10710 Trace d'accès aux index bitmap

Remarques

Mastodon LLIMastodon SocialFosstodon