Introduction
Qu'est-ce que Lighty ?
Lighty est un logiciel de supervision et de surveillance, permettant d'analyser et d'optimiser la charge de travail et les ressources utilisées par vos bases de données Oracle.
Le logiciel est compatible avec les versions 10.2 à 18.c d'oracle. Il fonctionne avec les versions Standard ou Entreprise (avec ou sans Diagnostic et Tuning Pack).
Lighty sait exploiter les particularités des bases RAC.
Fonctions Principales
| Vision des performances de plusieurs bases de données en simultané |
| Vision de l’activité d’une base en temps réel |
| Vision de l’activité passée (basée sur ASH ou L-ASH pour les versions Standard) |
| Permet d’explorer facilement les données historisées dans l’AWR ou Statspack |
| Permet de visualiser les principales statistiques liées aux ordres SQLs ou sessions |
| Navigation facile parmi les nombreuses informations des bases grâce aux rapports SQLs |
Voir la listes des fonctionnalités.
Prérequis Système
Le logiciel fonctionne sur les plateformes Windows et Linux.
Une option est prévue dans le logiciel pour vous permettre d'utiliser plus ou moins de mémoire suivant les besoins. Le besoin minimum en mémoire est de 256 Mo et peut aller jusqu'à 1024 Mo suivant votre choix. La valeur conseillée est de 512 Mo.
L'espace disque occupé est d'environ 200Mo.
Installation
Le logiciel est distribué en format compressé zip sur les environnements Windows.
Il suffit de décompresser ce fichier à l'endroit désiré. Un répertoire Lighty est alors créé avec une arborescence contenant tous les fichiers nécessaires à son fonctionnement. Lancer ensuite Lighty.exe.
| Une version du JRE (Java Runtime Environment) est incluse (version 7 update 51) |
| Pas besoin d'un client Oracle |
| Pas besoin d'être administrateur de son poste Windows |
| Le logiciel ne crée aucun objet dans les bases de données |
Lancement
Au lancement de l'application, le firewall va demander d'autorisation d'ouverture du port nécessaire à l'affichage de l'aide locale. Il suffit de cliquer sur "Annuler" pour ne plus recevoir ce message au prochain démarrage.
Mise à jour
La mise à jour du logiciel peut se faire de deux manières. Dans les deux cas, vos préférences seront préservées.
Une fenêtre apparaît, vous indiquant si vous utilisez la dernière version. Si ce n'est pas le cas, vous avez le choix de télécharger et installer automatiquement la dernière version. (Une connexion internet est nécessaire. Pour les accès internet à travers un proxy, il sera peut-être nécessaire de configurer cet accès à travers les options du logiciel).
Suppression de l'arborescence Lighty puis décompression du fichier zip.
Période d'évaluation
La version d’essai gratuite est pleinement fonctionnelle. Cependant, vous ne pouvez pas déclarer plus de 5 connexions. Quand la période d’évaluation est terminée, seul le monitoring multi-bases reste accessible.
Pour continuer à utiliser les autres options, vous devez acheter une licence.
Diagnostic et Tuning Packs
Les packs ASH et AWR sont des options payantes d'Oracle.
Si vous ne possédez pas ces licences, nous vous proposons l'utilisation alternative de Lighty ASH et Statspack.
L-ASH
L-ASH (Lighty ASH) est un petit utilitaire permettant de simuler la fonctionnalité ASH. Cet utilitaire prend une image toutes les 10 secondes des sessions actives. Ces images sont stockées dans une table pour pouvoir ensuite être restituées dans l'écran Activity Viewer.
Les scripts sont présents dans le sous-répertoire L-ASH de l'arborescence du logiciel.
Vous pouvez également télécharger le fichier L-ASH.zip qui contient tous les scripts.
Vous pouvez également télécharger le fichier L-ASH.zip qui contient tous les scripts.
Installation L-ASH
Se connecter à la base en tant que SysDBA
Exécuter le script installation.sql (ex : sqlplus sys/password@TNS_ALIAS as SysDBA @installation.sql)
Le script demande 2 paramètres : le mot de passe et le tablespace par défaut du compte ASHSTAT
Le script crée les objets suivants :
Un utilisateur nommé ASHSTAT (ou C##ASHSTAT à partir de la version 12.2)
2 tables
L_ASH - Table contenant les statistiques des sessions
PARAMETERS - Table de paramétrage
1 Package LIGHTY_PKG
LIGHTY_PKG.SET_RETENTION pour changer la rétention des statistiques (par défaut, 7 jours)
LIGHTY_PKG.SNAP pour prendre un cliché des sessions actives
LIGHTY_PKG.PURGE pour supprimer les anciennes données (rétention stockée dans la table PARAMETERS)
2 Jobs
ASHSTAT."L-ASH" - Exécute toutes les 10 secondes LIGHTY_PKG.SNAP
ASHSTAT."PURGE L-ASH" Exécuté une fois par jour pour effectuer la suppression des anciennes données
Installation Output
sqlplus / as sysdba SQL*Plus: Release 11.2.0.3.0 Production on Tue Feb 4 20:15:49 2014 Copyright (c) 1982, 2011, Oracle. All rights reserved. Connected to: Oracle Database 11g Enterprise Edition Release 11.2.0.3.0 - Production With the Partitioning, Real Application Clusters, Automatic Storage Management, OLAP, Data Mining and Real Application Testing options SQL> @installation installation of L-ASH V1.0 www.orachrome.com ----------------------------------- Choose ASHSTAT user's password ----------------------------------- Enter value for ashstat_pwd: ashstat Choose the Default tablespace for the ASHSTAT user --------------------------------------------------- Enter value for default_tablespace: users ... Creating ASHSTAT user ... Installing required packages SQL> alter session set current_schema=ASHSTAT; Session altered. SQL> set echo off feedback on; ... Create table L_ASH Table created. 1 row created. 1 row created. Table created. Index created. ... Create Package Lighty_pkg l_pkg112 1 row selected. Package created. No errors. Package body created. No errors. ... Create Scheduler jobs "L-ASH" and "PURGE L-ASH" PL/SQL procedure successfully completed. PL/SQL procedure successfully completed. ... View Scheduler jobs "L-ASH" and "PURGE L-ASH" OWNER JOB_NAME STATE START_DATE REPEAT_INTERVAL NEXT_RUN_DATE RUN_COUNT -------------------- -------------------- --------------- -------------------- -------------------------------------------------- -------------------- ---------- ASHSTAT L-ASH SCHEDULED 02/04/2014 20:16:03 FREQ=SECONDLY;INTERVAL=10 02/04/2014 20:16:03 0 ASHSTAT PURGE L-ASH SCHEDULED 02/04/2014 20:16:03 FREQ=DAILY;BYHOUR=22;BYMINUTE=0;BYSECOND=0 02/04/2014 22:00:00 0 2 rows selected.
Statspack
Statspack est un outil vous permettant de prendre à intervalle régulier des statistiques de votre base. Moins complet que l'AWR, il reste cependant une solution intéressante.
Pour installer Statspack, se connecter en tant que SysDBA
et exécuter le script spcreate.sql présent dans le répertoire "ORACLE_HOME"/rdbms/admin
et exécuter le script spcreate.sql présent dans le répertoire "ORACLE_HOME"/rdbms/admin
Niveau De Capture
Il existe plusieurs niveaux de captures possibles avec Statspack (le niveau par défaut est 5). Les différents niveaux ainsi que leur description sont visibles en interrogeant la table STATS$LEVEL_DESCRIPTION.
Pour bénéficier pleinement de Statspack avec Lighty, il est recommandé de passer le niveau de capture à 7 (comprend entre autres les statistiques sur les segments).
Vous pouvez directement mettre à jour la table STATS$STATSPACK_PARAMETER (nécessite d'avoir au moins un cliché présent par instance) :
sqlplus / as sysdba SQL*Plus: Release 11.2.0.3.0 Production on Tue Feb 4 20:15:49 2014 Copyright (c) 1982, 2011, Oracle. All rights reserved. Connected to: Oracle Database 11g Enterprise Edition Release 11.2.0.3.0 - Production With the Partitioning, Real Application Clusters, Automatic Storage Management, OLAP, Data Mining and Real Application Testing options SQL> @installation installation of L-ASH V1.0 www.orachrome.com ----------------------------------- Choose ASHSTAT user's password ----------------------------------- Enter value for ashstat_pwd: ashstat Choose the Default tablespace for the ASHSTAT user --------------------------------------------------- Enter value for default_tablespace: users ... Creating ASHSTAT user ... Installing required packages SQL> alter session set current_schema=ASHSTAT; Session altered. SQL> set echo off feedback on; ... Create table L_ASH Table created. 1 row created. 1 row created. Table created. Index created. ... Create Package Lighty_pkg l_pkg112 1 row selected. Package created. No errors. Package body created. No errors. ... Create Scheduler jobs "L-ASH" and "PURGE L-ASH" PL/SQL procedure successfully completed. PL/SQL procedure successfully completed. ... View Scheduler jobs "L-ASH" and "PURGE L-ASH" OWNER JOB_NAME STATE START_DATE REPEAT_INTERVAL NEXT_RUN_DATE RUN_COUNT -------------------- -------------------- --------------- -------------------- -------------------------------------------------- -------------------- ---------- ASHSTAT L-ASH SCHEDULED 02/04/2014 20:16:03 FREQ=SECONDLY;INTERVAL=10 02/04/2014 20:16:03 0 ASHSTAT PURGE L-ASH SCHEDULED 02/04/2014 20:16:03 FREQ=DAILY;BYHOUR=22;BYMINUTE=0;BYSECOND=0 02/04/2014 22:00:00 0 2 rows selected.
Rem Rem -------------------------------------------------------- Rem Rem Update Statspack Level to 7 Rem and sqls captured to 100 Rem Rem V1.0 Rem 15/09/2014 - Creation Rem Rem www.orachrome.com Rem -------------------------------------------------------- Rem update stats$statspack_parameter set SNAP_LEVEL=7,NUM_SQL=100 ; commit;
Programmation des clichés
Pour prendre des clichés Statspack, il faut programmer la procédure statspack.snap du schéma perfstat à intervalle régulier (en général toutes les heures).
Sur les environnements RAC, il est nécessaire d'exécuter la procédure sur chaque instance.
Le programme PL/SQL suivant permet de mettre en place la programmation de snapshots Statspack sur des bases standalone ou RAC.
Ce code PL/SQL crée un programme et un job d'exécution par instance. Sur les bases en mode RAC, pour éviter d'éventuelles contentions, les jobs sont lancés séquentiellement.
Ainsi, seul le job de l'instance 1 est programmé pour être exécuté à intervalle régulier. A la fin de son exécution, il déclenche le lancement du job sur l'instance 2, qui déclenche l'exécution du job sur l'instance 3, etc.
Rem
Rem --------------------------------------------------------
Rem
Rem This PL/SQL will create a hourly job
Rem to take a statspack snapshot
Rem
Rem RAC Aware
Rem
Rem V1.0
Rem 15/09/2014 - Creation
Rem
Rem www.orachrome.com
Rem --------------------------------------------------------
Rem
Rem Example of Dropping jobs and programs in a 2 instance Rac Database
Rem exec dbms_scheduler.drop_job('STATSPACK_SNAP_1');
Rem exec dbms_scheduler.drop_job('STATSPACK_SNAP_2');
Rem exec dbms_scheduler.drop_program('PROG_STATSPACK_SNAP_1');
Rem exec dbms_scheduler.drop_program('PROG_STATSPACK_SNAP_2');
Rem --------------------------------------------------------
Rem Installing jobs and programs
Rem --------------------------------------------------------
DECLARE
newjob SYS.job_definition;
newjobarr SYS.job_definition_array;
cpt NUMBER := 0;
name VARCHAR2(50);
command VARCHAR2(80);
jobenable BOOLEAN;
cptinstances NUMBER := 0;
repeatInterval varchar2(400);
startDate date;
BEGIN
newjobarr := sys.job_definition_array();
select count(*) into cptinstances from gv$instance;
newjobarr.extend(cptinstances);
-- Add a job and a program for each instance
FOR rec IN (select inst_id, max(inst_id) over () maxInstId,lead(inst_id,1,0) over (order by inst_id) nextInstId from gv$instance)
LOOP
name := 'STATSPACK_SNAP_' || rec.inst_id;
command :='';
IF (rec.inst_id < rec.maxInstId)
THEN
command := 'dbms_scheduler.enable(''STATSPACK_SNAP_' || rec.nextInstid || ''');';
END IF;
DBMS_SCHEDULER.CREATE_PROGRAM( program_name=> 'PROG_' || name,
program_action=>'BEGIN perfstat.statspack.snap;' || command || ' end;',
program_type=>'PLSQL_BLOCK',
number_of_arguments=>0,
comments=>'',
enabled=>TRUE);
IF (rec.inst_id =1)
THEN
jobenable := true;
repeatInterval := 'FREQ=HOURLY';
startDate := trunc(sysdate,'HH')+1/24;
ELSE
jobenable := false;
repeatInterval := null;
startDate := null;
END IF;
-- Create a JOB_DEFINITION object type
newjob := sys.job_definition(job_name => name,
job_style => 'REGULAR',
program_name => 'PROG_' || name,
repeat_interval => repeatInterval,
-- start_date => trunc(sysdate,'HH')+1/24,
start_date => startDate,
auto_drop => FALSE,
enabled => jobenable,
instance_id => rec.inst_id);
-- Add it to the array
cpt := cpt +1;
newjobarr(cpt) := newjob;
END LOOP;
-- Call CREATE_JOBS
DBMS_SCHEDULER.CREATE_JOBS(newjobarr, 'TRANSACTIONAL');
END;
Suppression des anciennes données
Vous pouvez supprimer manuellement les anciens clichés
en exécutant le script sppurge.sql présent dans le répertoire "ORACLE_HOME"/rdbms/admin
en exécutant le script sppurge.sql présent dans le répertoire "ORACLE_HOME"/rdbms/admin
Vous pouvez également programmer un job de suppression des anciens clichés.
Le script PL/SQL suivant crée un job quotidien (lancé tous les jours à 23h) de suppression des clichés Statspack. L'ancienneté des clichés est définie comme pour l'outil L-ASH par le package ASHSTAT.LIGHTY_PKG.SET_RETENTION (par défaut 7 jours de rétention).
Rem
Rem --------------------------------------------------------
Rem
Rem This PL/SQL will create a daily job (Runs every day at 11PM)
Rem to purge the statspack snapshots
Rem RAC Aware
Rem
Rem L-ASH must be installed
Rem The retention is stored in the table ASHSTAT.PARAMETERS
Rem Default : 7 Days
Rem
Rem V1.0
Rem 15/09/2014 - Creation
Rem
Rem www.orachrome.com
Rem --------------------------------------------------------
Rem
grant select on ashstat.parameters to perfstat;
exec dbms_scheduler.drop_job('"PERFSTAT"."PURGE STATSPACK"');
BEGIN
sys.dbms_scheduler.create_job(
job_name => '"PERFSTAT"."PURGE STATSPACK"',
job_type => 'PLSQL_BLOCK',
job_action => 'DECLARE
DAYS NUMBER := 7;
BEGIN
SELECT value INTO days FROM ashstat.parameters WHERE name=''retention'';
FOR instances in (select sp.dbid,INSTANCE_NUMBER
FROM stats$database_instance sp,v$database v
WHERE sp.dbid=v.dbid)
LOOP
FOR snapshot_range IN (SELECT min(snap_id) MIN_SNAP_ID ,max(snap_id) MAX_SNAP_ID
FROM stats$snapshot
WHERE dbid=instances.dbid
AND instance_number=instances.instance_number
AND snap_time < trunc(sysdate)-DAYS)
LOOP
IF (SNAPSHOT_RANGE.MIN_SNAP_ID IS NULL)
THEN
EXIT;
END IF;
statspack.purge( i_begin_snap => snapshot_range.MIN_SNAP_ID
, i_end_snap => snapshot_range.MAX_SNAP_ID
, i_snap_range => true
, i_extended_purge=> false
, i_dbid => instances.dbid
, i_instance_number => instances.instance_number);
END LOOP;
END LOOP;
COMMIT;
EXCEPTION
WHEN OTHERS THEN
RAISE_APPLICATION_ERROR(-20100,''PERFSTAT.STATSPACK PURGE Error'' || SUBSTR(SQLERRM, 1 , 1000));
END;
',
repeat_interval => 'FREQ=DAILY;BYHOUR=23;BYMINUTE=0;BYSECOND=0',
start_date => systimestamp,
job_class => '"DEFAULT_JOB_CLASS"',
comments => 'Purge statspack repository',
auto_drop => FALSE,
enabled => FALSE);
sys.dbms_scheduler.set_attribute( name => '"PERFSTAT"."PURGE STATSPACK"', attribute => 'job_weight', value => 1);
sys.dbms_scheduler.set_attribute( name => '"PERFSTAT"."PURGE STATSPACK"', attribute => 'auto_drop', value => TRUE);
sys.dbms_scheduler.enable( '"PERFSTAT"."PURGE STATSPACK"' );
END;
/
Rem Rem -------------------------------------------------------- Rem Rem Statspack Jobs Rem Rem V1.0 Rem 15/09/2014 - Creation Rem Rem www.orachrome.com Rem -------------------------------------------------------- Rem set lines 500 pages 40 head on col JOB_NAME for A20 col OWNER for A20 col REPEAT_INTERVAL for A50 col START_DATE for A20 col NEXT_RUN_DATE for A20 select OWNER,job_name,state,to_char(START_DATE,'MM/DD/YYYY HH24:MI:SS') START_DATE, REPEAT_INTERVAL, to_char(NEXT_RUN_DATE,'MM/DD/YYYY HH24:MI:SS') NEXT_RUN_DATE, run_count from dba_scheduler_jobs where regexp_like(job_name,'STATSPACK') /
Les scripts sont présents dans le sous-répertoire L-ASH de l'arborescence du logiciel.
Vous pouvez également télécharger le fichier L-ASH.zip qui contient tous les scripts.
Vous pouvez également télécharger le fichier L-ASH.zip qui contient tous les scripts.
En résumé, voici la séquence des actions à effectuer pour mettre en place une gestion complète de Statspack (en étant connecté SysDBA et en ayant au préalable installé L-ASH) :
- Installation Statspack + programmation clichés + purge anciennes données
- SQL>@?/rdbms/admin/spcreate (Installation de Statspack)
- SQL>exec perfstat.statspack.snap; -> si base en mode RAC, prendre un cliché par instance
- SQL>@lighty_sp_update_level.sql (modification du niveau de capture et nombre de SQLs capturés)
- SQL>@lighty_sp_snap_job.sql (programmation des captures)
- SQL>@lighty_sp_purge_job.sql (programmation de la suppression des anciens clichés)
- SQL>@lighty_sp_view_jobs.sql (visualisation des jobs précédemment créés)
Gestion de la rétention
Par défaut 7 jours d'historique d'activité sont gardés.
Pour modifier cette rétention, exécuter ASHSTAT.LIGHTY_PKG.SET_RETENTION
en spécifiant le nombre de jours que vous souhaitez garder en ligne.
Pour modifier cette rétention, exécuter ASHSTAT.LIGHTY_PKG.SET_RETENTION
en spécifiant le nombre de jours que vous souhaitez garder en ligne.
Configuration du logiciel
Pour que le logiciel prenne en compte ces 2 utilitaires, vous devez les signaler dans les propriétés d'une connexion. Pour ce faire, ouvrez les propriétés d'une connexion et sélectionnez les cases à cocher correspondantes.
Installation de l'agent depuis Lighty
Depuis la version 1.7.0, il est possible d'installer l'agent L-ASH directement depuis Lighty en cliquant sur le bouton Install
Il faut saisir les identifiants d'un compte Sysdba
Puis selectionner le tablespace et definir un mot de passe pour l'utilisateur de l'agent
A la fin de l'installation un message de reussite ou d'echec s'affiche, les logs sont disponnibles dans la fenêtre de droite et dans le presse-papier
Fonctionnement Général
Comment bien débuter avec Lighty
Barre d'outils principale
Cette barre d'outils peut être masquée. Toutes les options de la barre d'outils sont également disponibles dans les menus ou par l'intermédiaire de raccourcis clavier.
Raccourcis Clavier
| Raccourci | Description |
|---|---|
| Ctrl + G | Passage en mode multiple connexions |
| Ctrl + I | Passage en mode simple connexion |
| Ctrl + M | Affiche la page de configuration des connexions |
| Ctrl + A | Ajout d'une nouvelle connexion |
| Ctrl + O | Affiche la fenêtre d'options |
| Ctrl + N | Affiche ou cache la fenêtre flottante des connexions |
| Ctrl + R | Affiche ou cache la fenêtre flottante des rapports |
| Ctrl + Q | Affiche ou cache la fenêtre flottante des statistiques d'un SQL |
| Ctrl + S | Affiche ou cache la fenêtre flottante des statistiques d'une session |
Fenêtres Flottantes
Lighty utilise des fenêtres flottantes dans son interface graphique. Ces fenêtres peuvent être regroupées, déplacées sur un des bords de la fenêtre principale, redimensionnées ou cachées. Certaines peuvent être maximisées en double-cliquant sur la barre de titre ou sur l'icône correspondante.
| Fenêtre | Peut être maximisée | Déplaçable |
|---|---|---|
| Liste des connexions | ||
| Liste des rapports SQLs | ||
| Statistiques SQL | ||
| Statistiques Session |
Tableau de Bord
Le tableau de bord vous offre un aperçu de différentes statistiques d’activité via une page unique. Sa gestion se fait avec les icônes 
. Cette page unique est organisée en onglets. Vous pouvez ajouter un nouvel onglet à partir du bouton 
. Chaque onglet peut être nommé. Vous pouvez également fermer un onglet par le bouton prévu. A l’intérieur de chaque onglet, organisez votre tableau à l’aide de gadgets prédéfinis. Par défaut, le tableau comporte 3 colonnes dédiées aux gadgets. Réduisez ou augmentez le nombre de colonnes à l'aide du bouton 
. Les gadgets disponibles pour le tableau de bord sont visibles en cliquant sur le bouton 
. Pour intégrer un gadget au tableau de bord, il vous suffit de glisser-déposer le gadget à l'endroit voulu à l'aide de la souris. Les gadgets sont redimensionnables (largeur et hauteur). Vous pouvez également personnaliser ou supprimer n'importe quel gadget du tableau de bord. Un même gadget peut être ouvert plusieurs fois.
Certains gadgets possèdent des options. Dans ce cas, l’icône 
apparaît en haut à droite du gadget.
Une sauvegarde automatique de votre environnement est effectuée à chaque modification, vous assurant la persistance de votre tableau de bord.
Le principe de tableau de bord est utilisé dans 2 écrans (par défaut préremplis avec quelques gadgets) :
- Onglet "Activity Viewer" (Partie inférieure)
- Onglet "Real Time"
Liens Hypertexte
Les liens hypertexte vous permettent de naviguer facilement parmi les nombreuses informations disponibles. Ils sont de couleur bleue.
Dans l'écran des rapports, l'historique de votre navigation est affiché en haut de la fenêtre, vous permettant de revenir instantanément à l'information souhaitée.
Filtres
Les filtres sont omniprésents dans les différentes fenêtres du logiciel. Ils permettent d'isoler très facilement l'information désirée.
Il existe 3 types de filtre :
- La case à cocher
- Le champ texte
Le filtre est appliqué automatiquement au fur et à mesure de votre saisie - Les listes de valeurs
Le filtre est appliqué automatiquement suivant vos différentes sélections
Vous pouvez sélectionner plusieurs valeurs
Composant Timeline
Ce composant vous informe visuellement de l'activité d'un identifiant dans une fourchette de temps.
L'activité est répartie par classe d'attente Oracle
Couleurs spécifiques pour chaque classe
Couleurs spécifiques pour chaque classe
L'exemple ci-dessous vous montre la consommation de SQLs dans une fourchette de temps (11h50 à 14h10) :
Plusieurs informations sur un seul et même composant :
Les plages d'exécution
Le type d'activité
Le temps d'activité
Ce composant est présent dans de nombreux écrans et gadgets du logiciel.
Rafraîchissements automatiques
De nombreux écrans proposent un rafraîchissement des informations affichées.
Dans ce cas, les boutons 
vous permettent de gérer ce rafraîchissement.
Pour un rafraîchissement automatique, sélectionnez la case à cocher puis la fréquence dans la liste (10s, 30s ou 60s). Un décompte est affiché.
Pour un rafraîchissement manuel, cliquez sur l'icône correspondante.
Outils d'export
Le bouton d'export 
permet, suivant les fenêtres et le type d'information affichées de réaliser différentes opérations :
- Copie du contenu dans le clipboard
- Génération de rapport ASH (global, pour un SQL ou une session)
- Génération de rapport AWR au format HTML
- Génération de rapport ADDM au format HTML
- Génération de rapport d'un SQL supervisé au format HTML
Connexions
Ajout
L'ajout se fait par le bouton 
, le menu ou par le raccourci Ctrl + A.
Ajouter une connexion se fait en 3 étapes.
1 - Définition
Le nom de la connexion doit être unique.
Par défaut un pool de connexion de 10 sessions est préconisé et utilisé. Vous pouvez augmenter ou diminuer ce pool.
Le type et l'application vous permettent de grouper vos connexions suivant leurs fonctions.
Vous pourrez ainsi facilement identifier ces connexions par la suite (dans le menu ou dans le panneau de configuration).
2 - Configuration de la connexion standard
Définissez l'utilisateur ainsi que le mot de passe.
Une connexion en tant que SysDBA permet de visualiser certains rapports spéciaux (cache des données, paramètres cachés, contenu alert log...).
Le mot de passe peut être sauvegardé (sous format crypté) vous évitant ainsi une saisie à chaque connexion.
La configuration de la connexion peut se faire en saisissant le nom du serveur, le port et le nom de l'instance ou nom de service. Vous pouvez également saisir une chaîne complète de connexion (entrée TNS par exemple).
3 - Configuration de la connexion par Wallet
Lighty permet d'utiliser les Wallet Oracle pour effectuer des connexions sans mot de passe
- Sélectionner le répertoire du Wallet
- Sélectionner le répertoire du fichier tnsnames.ora (optionnel)
- Saisir l'alias de connexion (utilisé dans le fichier tnsnames.ora et dans le Wallet
- Cocher la case SSL si necessaire
La connection au base Autonomous Oracle est possible en utilisant ce type de connexion (SSL)
4 - Options
Choisissez ici les packs utilisés par la base de données. Par défaut, depuis la version 11G, le paramètre control_management_pack_access définit l'utilisation des packs de Diagnostic et Tuning.
Si vous n'utilisez pas ces packs, vous pouvez installer L-ASH (outil de simulation de la fonctionnalité ASH). Cochez ensuite l'option "L-ASH installed". Dans ce cas :
- La case "History days" permet de définir le nombre de jours de rétention des données.
- La case "History Sql" permet de mémoriser en plus les informations sur les requêtes.
Configuration des connexions
Cette fenêtre est accessible depuis le menu "Options", par l'icône 
ou par le raccourci Ctrl + M.
La fenêtre liste toutes les connexions définies. Vous pouvez ainsi modifier leur configuration, ou supprimer une connexion.
Lister les connexions
Vous pouvez lister les connexions par l'intermédiaire du menu "Connection List" ou par la Fenêtre Flottante du même nom.
Le menu regroupe les connexions par type et par application.
Activité d'une base
3 onglets vous permettent de naviguer parmi les statistiques.
Si vous n'avez pas la licence Diagnostic Pack,
vous pouvez installer L-ASH permettant de simuler la fonctionnalité ASH
vous pouvez installer L-ASH permettant de simuler la fonctionnalité ASH
L'onglet "Activity Viewer" permet de visualiser l'activité d'une base de données. Basé sur les données issues de la fonctionnalité "Active Session History", cet écran vous aide dans la compréhension de l'activité.
Au milieu de cet écran se trouve le graphe principal.
Ce graphe représente sur une fourchette de temps l'activité consommée de votre base de données, répartie par classe d'attente et consommation CPU.
Pour isoler l'information souhaitée, plusieurs possibilités s'offrent à vous :
- Sélection d'une fourchette de dates
- Filtrer les données
- Zoom sur une partie du graphique
- Choisir uniquement les données issues de la SGA (buffer ASH) pour encore plus de précision
- Organiser l'affichage de votre tableau de bord
1 - Sélection d'une fourchette de dates
Celle-ci se fait à l'aide des boutons :
Vous choisir exactement la date et heure de début et de fin en cliquant sur le bouton "Custom" puis en saisissant les dates/heures de début et fin
Vous pouvez également choisir la période avant ou après la période courante en utilisant les boutons "Prev" 
et "Next" 
2 - Filtrer les données
Le filtre de type champ vous permet de saisir un SQL ID ou un SID de session.
Vous pouvez également afficher / masquer la liste des filtres prédéfinis à l'aide du bouton 
.
Ces filtres sont configurables (bouton 
) à partir d'une liste d'une vingtaine d'éléments.
3 - Zoom sur une partie du graphique
Utilisez la souris pour sélectionner une partie du graphique et n'afficher que les statistiques correspondantes.
Les boutons du graphique 
(ou le menu clic droit de la souris) vous permettent de sauvegarder, copier dans le presse-papier, sélectionner le zoom, supprimer le zoom...
4 - Choisir uniquement les données issues de la SGA (buffer ASH) pour encore plus de précision
Ce choix se fait en cochant la case 
.
Une fois sélectionnée, toutes les données affichées seront issues uniquement de la mémoire SGA et plus exactement du buffer ASH.
Le bouton 
vous permet de voir la rétention, le nombre de lignes et la taille de ce buffer (par instance).
5 - Organiser l'affichage de votre tableau de bord
| Gadget | Description | Composant Timeline | Options Possibles |
|---|---|---|---|
| Graphique | Affiche l'activité d'un sous-ensemble sous forme de graphe de type camembert ou historique |
Graphique de type camembert ou historique Choix de la statistique (machine, programme, utilisateur, identifiant client, module, action, opération SQL, SQL, évènement système) |
|
| Sessions |
Affiche les sessions. Permet d'affiner l'information en affichant les SQLs pour une session. |
||
| SQLs |
Affiche les SQLs Permet d'affiner l'information en affichant les évènements système pour un SQL. Le plan d'exécution est affiché à côté du SQL. Lorsqu'il y a plusieurs plans, c'est le nombre de plans qui est affiché. Possibilité ensuite d'afficher les différents plans en cliquant sur l'icône de l'arborescence. |
||
| Scripts PL/SQL |
Affiche les scripts PL/SQL Permet d'affiner l'information en affichant les SQLs pour un PL/SQL. |
||
|
Service, Module, Action |
Affiche l'activité par service, module, action | Regroupement sur un ou plusieurs critères | |
| Machine, Programme, Utilisateur | Affiche l'activité par machine, programme, utilisateur | Regroupement sur un ou plusieurs critères | |
| Identifiant Client | Affiche l'activité par identifiant client | ||
| Classe d'Attente, Evènement Système | Affiche l'activité par classe d'attente et / ou évènement système | ||
| Instance, Service | Affiche l'activité par instance et / ou service | Regroupement sur un ou plusieurs critères | |
| Segments | Affiche l'usage des segments | ||
| PGA, Usage espace temporaire | Affiche la PGA ou l'espace temporaire maximum utilisé dans l'intervalle de temps | Regroupement par SQL ou session | |
| Sessions bloquantes | Affiche les sessions bloquantes ainsi que les sessions bloquées dans l'intervalle de temps |
Temps Réel
Le panneau vous donne en temps réel l'activité ainsi que les statistiques de votre base.
Il est organisé en tableau de bord vous permettant de customiser l’affichage.
| Certains gadgets montrent l'activité instantanée : |
| Les SQLs supervisés |
| Les opérations longues de sessions |
| L'usage des espaces temporaires, PGA |
| Les transactions en cours |
| Les sessions bloquantes |
| Certains gadgets affichent des statistiques incrémentales calculées entre 2 clichés. |
| Les statistiques système |
| Les verrous de type "Latches" |
| Les histogrammes d'évènement |
| Les segments utilisés |
| Certains gadgets affichent des statistiques incrémentales calculées entre 2 clichés. |
L'activité est répartie par classe d'attente Oracle
(bouton situé en haut à droite de chaque gadget)
(bouton
situé en haut à droite de chaque gadget)
Un même gadget peut être ouvert plusieurs fois.
Rapports
L'onglet "Reports" vous permet d'explorer les statistiques de votre base de données. Ces rapports sont répartis par catégorie et sous-catégorie pour plus de simplicité. (Les textes sont laissés volontairement en anglais)
| Catégorie | Sous-Catégorie |
|---|---|
| DB Information | Db Information, Properties / Usage, Parameters, Memory Components, Alerts, Alert Log, FRA, Backups |
| Physical Design | Tablespaces, Db Files, Redo Logs, Archiving Activity |
| DB Statistics | Current Activity (ASH), Past Activity (AWR), Past Activity (Statspack), Db Statistics, Statistics/Optimizer |
| Sessions | Sessions, Blocking Sessions, Session Long Operations |
| SQLs | Running SQLs, Monitored SQLs, Top 100 SQLs, Not Shared SQLs |
| Segments / Tables | Objects by Schema, Tables/Indexes/... |
| Locks / Transactions | Active Transactions, Recovering Transactions, Dictionary Cache Activity |
La navigation par lien hypertexte et l'affichage de l'historique de navigation rendent aisé le passage d'une information à une autre.
Certains rapports nécessitent les licences Diagnostic et Tuning packs
Lighty empêche leur exécution si vous cochez les bonnes options au niveau de la connexion
Il s'agit des rapports concernant l'exploration du référentiel AWR, des SQLs supervisés et de la visualisation de l'activité ASH
Lighty empêche leur exécution si vous cochez les bonnes options au niveau de la connexion
Il s'agit des rapports concernant l'exploration du référentiel AWR, des SQLs supervisés et de la visualisation de l'activité ASH
Certains rapports ne sont accessibles qu'en étant connecté SysDBA
Cache de données, paramètres cachés, contenu du fichier d'alerte
Cache de données, paramètres cachés, contenu du fichier d'alerte
Statistiques SQL
Une fenêtre de type Fenêtre Flottante est dédiée aux statistiques d’un SQL. Elle est affichée automatiquement lorsque vous cliquez sur le SQL ID présent sur les différents écrans.
Vous pouvez également saisir le SQL ID (éventuellement le numéro de "child") pour effectuer une recherche manuelle.
Cette fenêtre peut être maximisée en double-cliquant sur la barre de titres
| Retrouvez toutes les informations liées à un SQL |
| Les différents plans d’exécution (y compris ceux stockés dans le référentiel AWR ou Statspack) |
| Les statistiques d'exécution issues de l’AWR ou de Statspack |
| L'usage du SQL par les sessions sous forme de Timeline |
| Les statistiques d'exécution présentes dans le cache (SQL Area) |
| Les profils, patches, baselines présents |
Les statistiques sont visualisables par exécution, par fetch ou par ligne retournée.
(à l’aide des boutons
)
(à l’aide des boutons
)
Vous pouvez visualiser les bind variables passées ainsi que l’environnement de l’optimiseur
pour chaque plan d’exécution ainsi que pour chaque curseur SQL présent dans le cache.
pour chaque plan d’exécution ainsi que pour chaque curseur SQL présent dans le cache.
Activity Viewer Compare
Depuis la version 1.7.0, le bouton Compare de l'Activity Viewer, permet de scinder la fentre en deux, afin de comparer deux périodes d'activités différentes
• La base courante avec un snapchot (export) d’une base sauvegardé au préalable.
• Vous pouvez aussi comparer deux états antérieurs (exports).
• Ou une même base à deux moments différents.
Vous pouvez choisir "Actual Source" ou le bouton Import.
Rapports
Dans la partie "Reports" se trouvent différents rapports mettant en avant les informations les plus pertinentes pour le travail des DBAs. Depuis la version 1.6.0 vous avez la possibilité de créer vos propres rapports personnalisés.
Depuis la version 1.7.0 les rapports AWR et Statspack ont un onglet dédié qui apparait si l' option est activée 
Il y a trois nouveaux rapports qui ont fait leur apparition :
- Gestion et Visualisation des Jobs
- Comparaison de deux rapports AWR
- Rapports Statspack
Gestion et Visualisation des Jobs
Dans cette vue vous pouvez visualiser les différents jobs. Vous avez aussi la possibilité d'Activer ou de Désactiver un job.
Comparaison de deux rapports AWR
Vous pouvez désormais comparer deux rapports AWR et générer un rapport comparatif au format HTML. Il faut sélectionner dans la vue ci-dessous le premier des deux rapports que vous souhaitez comparer (il suffit de cliquer sur le lien "Compare To..." à côté du rapport choisi).
Maintenant il reste à choisir le deuxième rapport que vous souhaitez comparer (il faut cliquer sur le lien "Compare")
Ceci génère un rapport comparatif au format HTML.
Rapports Statspack
Dans la partie "Pack Activity (Statspack)" une nouvelle fonctionnalité a été ajoutée. Elle permet de générer un rapport au format texte.
Pour générer un rapport il faut au préalable définir une connexion SSH
Sélectionnez le menu "Current connection / Informations"
Puis saisissez un compte qui permet d'exécuter sqlplus (le script spreport.sql est utilisé)
Cliquez sur "Text Report" et le rapport au format texte est généré.
Statistiques Sessions
Une fenêtre de type Fenêtre Flottante est dédiée aux statistiques d’une session. Elle est affichée automatiquement lorsque vous cliquez sur le SID d’une session présent sur les différents écrans.
Vous pouvez également saisir le SID pour effectuer une recherche manuelle.
Cette fenêtre peut être maximisée en double-cliquant sur la barre de titres
(ou sur l’icône correspondante)
(ou sur l’icône correspondante)
| Retrouvez toutes les informations liées à une session |
| Les informations de connexion |
| Les curseurs ouverts |
| L’environnement de l’optimiseur |
| Les statistiques de la session (incrémentales et globales) |
| La transaction courante |
| L’historique d’exécution des SQLs sous forme de Timeline |
Import / Export Databases
Vous avez la possibilité d'importer et d'exporter les connexions aux bases de données entre les logiciels Lighty
Kill une session
Vous pouvez kill une session depuis l'interface de Lighty
Exporter des rapports
Vous avez la possibilité d'exporter les rapports dans un format CSV
Lancer un snap Statspack / AWR et L-ASH / ASH
Vous pouvez lancer un snap Statspack / AWR et L-ASH / ASH (selon la configuration de vos bases) pour réaliser des analyses sur les période voulues
Activer / Désactiver une trace d'une session
Vous pouvez activer et désactiver une trace sur une session depuis Lighty (le chemin du fichier de trace généré est affiché dans le logiciel)
La fonction Duplicate du SQL Report Wizard
Le SQL Report Wizard permet aussi de dupliquer ou de modifier des rapports déjà existants. La fonction "Duplicate" a été conçue afin de créer des rapports personnalisés en prenant pour base des rapports existants. Ainsi un utilisateur lambda pourra définir ses propres rapports sans pour autant modifier ceux déjà existants. Ce sera pour lui un gain de temps considérable car s’il existe déjà un rapport similaire à celui désiré, il n’aura pas à tout recréer. Le bouton duplicate se trouve dans l’onglet Report en bas de l’écran.
Pour dupliquer un rapport, il vous suffit d’ouvrir un rapport existant et de cliquer sur le bouton "Duplicate". Ceci vous ouvrira l’éditeur de rapport avec les différents champs préremplis avec les valeurs de l’ancien rapport. Seul le nom par défaut est modifié afin de ne pas avoir deux noms identiques.
Une fois le rapport dupliqué vous pourrez le modifier, le supprimer ou le dupliquer à nouveau à votre convenance.
Attention, on ne peut modifier ou supprimer un rapport que si on l'a précédemment ajouté.
Les rapports par défaut contenus dans Lighty ne sont par conséquent ni modifiables, ni supprimables.
Gestion Exadata
Si vous disposez d'une licence Lighty Exadata, des vues supplementaires vous permettent de suivre l'état de votre serveur
Configuration globale
Le cadre Options permet de définir les paramètres de connexion à un serveur Exadata.
La récupération des informations Exadata se fait en utilisant l'outil DCLI via une connexion SSH
Si une connexion SSH est déjà définie pour la connexion, et qu'elle référence le serveur exécutant DCLI, il est inutile de saisir les paramètres.
L'option Metrics History permet de spécifier la profondeur de l'historique à afficher pour les graphiques du Real Time au 1er affichage.
Plus la valeur de Metrics History est élevée, plus le temps de 1er affichage sera important.
Le champ DCLI Cell group doit être correctement renseigné sous peine de ne remonter aucune information
Rapports
La section Exadata de la liste des rapports contient 2 nouvelles entrées
Cell List
Ce rapport affiche la liste des Cells ainsi que leur statut et leurs températures
Cell List Detail
Ce rapport affiche les informations pour un Cell sélectionné depuis le rapport Cell List
Db metrics
Permet, à l'instar du Real Time, d'afficher une courbe représentant une métrique Database (parmi 4), en spécifiant une date. La courbe va alors afficher les valeurs 10 minutes avant et 10 minutes après la date sélectionnée (si elles sont encore présentes dans l'historique).
Les graph sont cumulatifs : les courbes s'ajoutent. Pour supprimer une courbe il faut cliquer sur sa légende.
Onglet "Real Time"
3 Onglets supplémentaires permettent d'afficher les metrics Exadata
Exadata Disk I/Os
Présente 8 métriques d’écritures/lectures sur les disques HDD et Flash, pour chaque Cell.
Les graph sont cumulatifs : les courbes s'ajoutent. Pour supprimer une courbe il faut cliquer sur sa légende.
La courbe SUM représente la limite du cumul
La courbe SUM représente la limite du cumul
Exadata Disk Request I/Os
Présente 8 métriques de demande d'écritures/lectures sur disques HDD et Flash, pour chaque Cell.
Exadata
4 métriques qui détaillent les % d’écritures/lectures par Base + une métrique CPU par Cell + une métrique température par Cell.
L'organisation des métriques peut être personnalisée, comme les métriques habituelles, en utilisant la palette et en rajoutant des onglets si nécessaire.
Monitoring d'une base
Vous avez la possibilité d'activer une surveillance automatique de certaines métriques d'une base.
Introduction
Le but est de pouvoir envoyer des emails d’alerte lorsque la valeur d’une métrique pour une connexion active dépasse un certain seuil.Les valeurs suivies sont issu des "Chart" de l’onglet "Real Time".
Pour l’instant, seuls les types de valeurs suivants peuvent être monitorés :
- Chart I/O : valeurs write/s et read/s
- Chart response Time : valeur CPU
- Chart Avg Active session : valeur Avg Active session
Principe de déclenchement d’une alerte
Pour chaque connexion active, on utilise la fonction de rafraîchissement des charts pour tester si le type de valeur affiché doit être monitoré.- Si c’est le cas, on s’assure que l’intervalle de temps écoulé depuis la dernière vérification (check interval) est supérieur ou égal à la durée définie pour ce type de valeur
- Si le temps écoulé est suffisant, on vérifie la valeur.
- Si la valeur est supérieure ou égale au seuil défini pour ce type, on passe en "warning" et on redéfinit l’intervalle de vérification (retry interval)
- Si l’état "warning" est atteint consécutivement le nombre de fois défini pour ce type (max check attempts), on déclenche l’envoi d’une alerte
Par exemple pour Chart response Time : valeur CPU
On a un check interval de 5 minutes, un retry interval de 2 minutes, un max check attempts égal à 3 et un % CPU de 10%
La vérification va avoir lieu toutes les 5 minutes.
- Si la valeur est supérieure ou égale à 10% on passe en warning et on vérifie ensuite toutes les 2 minutes.
- Si on a 3 warnings consécutifs, on envoie une alerte. Puis on efface le warning et on recommence à vérifier toutes les 5 minutes.
- Si on passe sous le seuil des 10% avant d’atteindre les 3 warnings, on recommence à vérifier toutes les 5 minutes.
Configuration globale
Elle s’effectue depuis la boîte de dialogue "Options : Menu Tools / Options", onglet "Monitoring"
Dans le cadre "Monitoring Configuration", on définit les paramètres par défaut de tous les monitorings.
Ces paramètres seront utilisés si la case "Default" d’un monitoring est cochée.
La case "Enable the monitoring" permet :
- de désactiver tous les monitorings (case décochée)
- ou bien de les rendre accessibles à la modification (case cochée).
- On peut activer ou désactiver un monitoring (case en haut à gauche du cadre).
- On peut utiliser les valeurs globales par défaut pour "Check Interval", "Max Check Attempts" et "Retry Interval" en cochant la case "Default".
- Si la case "Default" n’est pas cochée, on peut personnaliser ces valeurs.
Configuration par connexion
Depuis l’écran "Connection Manager" (accessible via le menu "Tools"), il faut sélectionner une connexion dans la liste puis cliquer sur le bouton droit de la souris pour faire apparaître le menu contextuel.
L’option "Configure Monitoring" permet d’ouvrir la fenêtre de configuration pour la connexion sélectionnée.
- Pour cette connexion on peut alors choisir d’activer le monitoring : case "Enable the monitoring".
- Puis pour chaque type de valeur à monitorer on peut choisir d’utiliser les valeurs par défauts, dans ce cas les valeurs globales seront utilisées et le cadre sera grisé.
- Sinon, on peut redéfinir ces valeurs pour cette connexion.
Note : si le monitoring global est désactivé, cet écran restera entièrement grisé.
L’envoi d'email
Suivant le type de licence, on peut ou non saisir le ou les destinataire(s) dans le champ Email.
- Pour une licence simple, le mail utilisé n’est pas modifiable, c’est celui qui a été renseigné lors de la demande de licence.
- Pour une licence multi-site, on peut modifier le mail global et le redéfinir pour chacune des connexions. Si pour une connexion le champ est laissé vide, alors le mail global sera utilisé.
Note : On peut saisir plusieurs destinataires en séparant les adresses par un ";".
Exemple d'email :
La configuration du serveur SMTP pour l’envoi de mail se fait depuis la fenêtre "Option" (menu "Tools/Options"), onglet "Email".
Impact sur les performances
Le monitoring utilise les données remontées par les Charts de la partie Real Time.Aucune requête supplémentaire n’est effectuée, donc l’impact sur le serveur DB est nul.
L’application Lighty est impactée modérément.
Une liste de monitoring actif est maintenue pour faciliter la recherche. Elle contient pour chaque connexion active la liste des types de valeurs à surveiller.
La boucle d’affichage des Charts effectue pour chaque nouvelle valeur une recherche dans cette liste, pour savoir si un monitoring est en cours pour ce type de valeur et cette connexion.
Si une alerte doit être envoyée, elle est mise en file d’attente. L’envoi d’un mail est traité dans un thread séparé.
Note : Les Charts étant rafraîchis toutes les minutes, on ne peut pas descendre au-dessous de cette valeur pour la fréquence de test d’une valeur (check interval).
SQL Report Wizard
Le SQL Report Wizard est un outil permettant de créer ses propres rapports. Cet outil de configuration des rapports est accessible via le menu "Tools" puis "SQL Reports Wizard". Les rapports générés se trouvent dans le menu à gauche de l'écran, avec les rapports existants.
 |
 |
 |
||
| Menu | Bas de fenêtre | Fenêtre Reports |
Pour ajouter un rapport, il faut passer par le menu SQL Report Wizard.
Pour modifier ou supprimer un rapport, il faut l’afficher en le sélectionnant dans la fenêtre Reports (accessible depuis le menu Windows) et cliquer sur les liens en bas du rapport.
On ne peut modifier ou supprimer un rapport que si on l'a précédemment ajouté.
Les rapports par défaut contenus dans Lighty ne sont par conséquent ni modifiables, ni supprimables.
Détails des écrans
1 - SQL Properties
Un rapport exécute une requête SQL dont on définit les propriétés dans ce 1er écran.
Tout d’abord, il faut spécifier le type de résultat que l’on veut :
| Default table |
|
| Single Line table properties |
|
| Tree Table Properties | ... |
| Text Area |
|
| Html Area | La requête renvoie une sortie HTML qui est affichée dans le navigateur par défaut |
| Clob Text | ... |
| Refreshable |
Le rapport sera rafraîchi périodiquement, la période peut être configurable 
|
| Diag Pack Needed | Utilise Diag Pack |
| AWR Exportable |
Le menu export est complété par les exports AWR 
|
| Statspack | Utilise Statspack |
| Only For SysDBA User | N’apparaîtra que pour les utilisateurs SysDBA |
| Tuning Pack Needed | Utilise le Tuning pack |
| ASH Exportable |
Le menu export est complété par les exports ASH 
|
Une requête parent sera rattachée à une catégorie à sélectionner dans la liste :
Le rapport apparaîtra alors dans l’arborescence de la catégorie ainsi que dans la catégorie My Report.
Attention, en supprimant la catégorie choisie, vous supprimez toutes les requêtes associées.
Une requête child n’est quant à elle rattachée à aucune catégorie, elle sera flottante dans l’arborescence. Sauf si on la rattache à un groupe existant, dans ce cas-là elle sera bien associée à la catégorie de ce dernier.
Une requête peut créer un groupe (un groupe peut être vu comme une sous-catégorie) ou rejoindre un groupe par sélection dans la liste.
Création :
Adhésion à un groupe :
En cas d’absence de groupe, le rapport ne sera visible que dans la catégorie My Report.
Le champ Keyword sera utilisé pour la recherche de rapport, en complément du nom.
Exemple graphique :
2 - SQL Versions
Dans cet écran, on peut configurer plusieurs plages de versions. Pour chacune d'entre elles, on pourra définir une requête compatible.
Par défaut, une ligne existe pour les bases de version minimale 10.2.
Pour modifier les versions Min et Max, il faut sélectionner les nouvelles valeurs dans les listes dédiées puis cliquer sur "Modify".
Pour ajouter une ligne, il faut cliquer sur "Add". Les valeurs sélectionnées dans les listes sont alors utilisées pour créer la nouvelle ligne.
Pour supprimer une ligne, il faut la sélectionner et cliquer sur "Delete".
Les plages des différentes lignes ne doivent pas se recouvrir.
La valeur Max 99999 doit apparaître dans une ligne.
La colonne Valid indique si une requête est définie pour cette plage de version.
Avant de passer à l’écran suivant, il faut sélectionner la ligne pour laquelle on va définir la requête.
3 - SQL Text
Cet écran permet de saisir la requête qui va extraire les données du rapport.La requête sera utilisée pour les bases dont la version correspond à la plage sélectionnée sur l’écran précèdent.
La valeur des paramètres éventuels de la requête est représentée par le caractère "?".
Le bouton Parse permet de tester la requête en utilisant la base sélectionnée dans la liste Connection to test.
En cas de succès, la mention "Parse succeeded" est affichée.
4 - Columns Definitions
C’est ici que l’on peut paramétrer chacune des colonnes de la requête.
| Displayed | Indique si la colonne sera affichée dans le rapport |
| Filtered | Indique si la colonne pourra servir à filtrer des résultats (voir écran Filter Values) |
| Incremental | Indique si la colonne affiche la différence avec le résultat précèdent de la requête (cas d’une requête qui est rafraîchie périodiquement) |
| Virtual | Indique si la valeur de la colonne sera calculée en fonction de 2 colonnes (voir écran Virtual Columns) |
| Type |
Indique le type de valeur retournée. Le type peut être redéfini grâce à une liste; suivant le type, la colonne affichera des liens par défaut vers d’autres fenêtres. Exemple : Pour le type SID (Session ID), un clic sur la valeur permet d’ouvrir la fenêtre Session statistics 
|
| ProgressBar |
Indique si la colonne affiche les valeurs sous la forme d’une barre de progression (voir écran Progress Bar properties). Exemple :
|
| Linked |
Indique si la colonne affiche un lien vers un autre rapport (voir écran Linked Column) Exemple : 
|
| Min. Width | Indique la taille minimale en pixel de la colonne |
5 - Virtual Columns
Cet écran permet de définir la méthode de calcul des valeurs pour les colonnes dont le paramètre Virtual a été coché.
Après avoir sélectionné la colonne à traiter dans la liste, il faut choisir les 2 colonnes dont les valeurs vont être utilisées, ainsi que l’opération à réaliser pour obtenir la valeur finale.
 |
 |
 |
| Opérande 1 | Opérateur | Opérande 2 |
6 - Parameters
Cet écran permet de définir le type de chaque paramètre identifié par un "?" dans la requête.
Après avoir sélectionné le paramètre dans la liste, on peut définir son nom et son type.
L’affichage de la zone de saisie du paramètre sera adapté au type sélectionné.
Exemple : un type Tablespace List présente la liste déroulante des Tablespaces.
Si on coche la case PDB Parameter, le type PDB List sera automatiquement sélectionné
Le type Select Result permet d’utiliser le résultat d’une requête pour remplir une liste de choix
La vérification de la requête se fait via le bouton Parse SQL.
7 - Progress Bar Columns Properties
Cet écran permet de paramétrer les colonnes dont les valeurs s’affichent sous forme de barre de progression.
Après avoir sélectionné la colonne, il faut choisir la couleur d’affichage et le type parmi :
8 - Linked Columns
Cet écran permet de paramétrer les liens des colonnes dont l’attribut Linked a été coché.
Si la requête n’a qu’un seul paramètre, le rapport peut être défini comme étant celui affiché par défaut, lorsqu'on clique sur une colonne dont le nom est défini dans le champ Column Linked.
Cela signifie que, si un autre rapport comprend une colonne du même nom, un clic sur une valeur de cette colonne affichera le rapport par défaut.
Pour chaque colonne linked on peut définir le rapport à appeler.
Si le rapport a besoin de paramètres issus du rapport appelant, il faudra les ajouter dans la liste Used Column Names.
Deux types de paramétrage permettent l’appel d’un rapport :
1. Simple Link to SQL : affiche le rapport sélectionné dans la liste Linked to SQL.
2. Conditional Link depending on column Values : affiche des rapports en fonction de la valeur d’une colonne.
• Depending on value of : permet de sélectionner la colonne
• When : permet de saisir la valeur
• Then : permet de sélectionner le rapport correspondant
Les boutons Add et Remove permettent d’ajouter ou de supprimer des conditions.
9 - Filter Values
Cet écran permet de paramétrer les filtres qui seront présentés en entête de rapport
Pour chaque colonne dont l’attribut Filtered à été coché on peut choisir le mode d’affichage parmi :
| CheckBox Filter | Utilisé pour les colonnes de type Yes / No, il affiche une case à cocher et un label défini dans le champ Filter Displayed Text. La valeur utilisée pour filtrer lorsque la case est cochée est définie dans le champ Filter value Exemple : pour la colonne IsDefault on aura l’affichage suivant :   |
| Field Filter | Affiche un champ de saisie d’une valeur pour le filtre. Pour les bases multitenant le filtre sur le PDB est automatiquement ajouté  |
| Panel Filter | Affiche un panel contenant les valeurs de toutes les colonnes définies comme filtered Exemple : ici Backup type et Status sont des colonnes utilisées pour le filtrage  |