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
- Une modification faite avec
scope=spfilen'est prise en compte qu'après redémarrage de l'instance. - Le fichier de trace d'une session est obtenu avec
oradebug tracefile_name.