Introduction
Qu'est-ce que Lighty ?
Lighty est un logiciel de supervision et de suivi des performances de bases de données PostgreSQL.
Le logiciel est compatible avec les versions supérieures ou égales à la 9.6.
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 |
| Navigation facile parmi les nombreuses informations des bases grâce aux rapports SQLs |
| Comparaison de l'activité sur différentes périodes et pour différentes bases |
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 8 update 161) |
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.
L-ASH
L-ASH (Lighty ASH) est un petit utilitaire permettant de simuler la fonctionnalité ASH. Cet utilitaire prend une image toutes le secondes environ des sessions actives. Ces images sont stockées dans des 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.
Installation L-ASH
- Se connecter sur le serveur PostgreSQL.
-
Editer le fichier postgresql.conf et modifier les lignes suivantes :
shared_preload_libraries = 'pg_stat_statements' pg_stat_statements.track = all track_io_timing=on
- Installer la lib contrib (exemple: yum install postgresql10-contrib).
- Se logger sous un compte ayant accès à psql.
- Copier le fichier init_service.sh et attribuer les droits d'exéctution: chmod +x .
- Dezipper le fichier l_ash.zip.
- Exécuter le script init_service.sh
-
Exécuter le script ./l_ash/lighty.sh add avec pour parametres dans l'ordre :
- Le port de connexion au serveur Postgres : 5432 habituellement
- Le nom du serveur qui héberge la base : localhost habituellement
- Le nom d'un utilisateur PostgreSQL : postgres habituellement
- Le nom de la base PostgreSQL : postgres habituellement
- Le mot de passe de l'utilisateur PostgreSQL
./lighty.sh add 5432 localhost postgres postgres passwordExécuter le script init_service.sh avec le port de l'instance PGSQL. Si plusieurs instances sont présentes, exécuter plusieurs fois le script.
Le schéma contient les tables utilisées pour la retention des informations sur 7 jours maximum.
La commande lighty.sh start est ensuite lancé, elle s'occupe de realiser des snapshot toutes les 10 secondes et de purger les données obsolétes.
La script lighty.sh start est inscrit pour un lancement au reboot dans le Crontab.
Il est possible d'installer le script de collecte sur un serveur Tier (pour collecter sur une base AMAZON RDS par exemple).
Dans ce cas il faut remplacer le localhost par l'adresse de l'instance.
La version actuelle de l'agent est : 1.2.1
Utilisation de Lighty.sh
- Se connecter sur le serveur PostgreSQL.
-
lancer la commande l_ash/lighty.sh avec les paramètres suivants :
- add PORT HOST USER DB PWD : ajoute le suivi d'une instance (voir plus haut)
- remove PORT HOST : supprime le suivi d'une instance
- status : renvoie la liste des process de collecte lancés (1 par instance)
- stop PORT HOST USER DB : arrete la collecte pour une instance identifiée par son port et son adresse
- start PORT HOST USER DB : lance ou relance la collecte, il faut fournir le Port, l'adresse, l'utilisateur (postgres en général) et la base (postgres en général) de l'instance Postgres
- stopall : arrête tous les process de collecte
- version : affiche la version du script
-bash-4.2$ l_ash/lighty.sh status /var/lib/pgsql/l_ash/Lightylocalhost5432.pid started : 591
Le fichier Lightylocalhost5432.pid contient le pid du processus Lighty.sh lancé : ici 591.
La mention started indique l'etat du processus.
Il es possible de saisir uniquement le 1er parametre d'une commande (l'action), dans ce cas les autres parametres seront demandés en mode interactif
Utilisation de LightyAgent pour Windows
Il est possible d'installer un agent de collecte sous windows, pour une instance locale ou bien pour une instance distante.
Dans ce cas il faut :
- Dezipper le fichier l_ash.zip.
- Exécuter init.bat avec le paramètres suivants PORT HOST USER DB PASSWORD
Fonctionnement Général
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 / 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 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
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
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
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 - Options de la connexion
Definissez le nombre de jours de retention des données pour le gadget SQL Aggregate
Attention : plus le nombre de jours est grand plus la base Lighty sera volumineuse !
Configuration des connexions
Cette fenêtre est accessible depuis le menu "Options" , par l'icône 
ou via le raccourci Ctrl + M.
La fenêtre liste toutes les connexions définies. Vous pouvez ainsi modifier leur configuration, ou supprimer une connexion.
Cette fenêtre est accessible depuis le menu "Options" , par l'icône ou via le raccourci Ctrl + M.
La fenêtre liste toutes les connexions définies. Vous pouvez ainsi modifier leur configuration, ou supprimer une connexion.
1 - Retention des données
La retention definie le nombre de jours pendant lesquels les données collectées sont concervées (et exploitables par Lighty). Elle est de 7 jours par défaut mais peut-être modifiées celons les besoins.
2 - Mise à jour de l'agent
Le bouton Check Agent Version permet d'interroger la base Lighty pour récupérer la version utilisée par l'agent installé, ainsi que le site Lighty Software pour obtenir la dernière version disponible.
Si une connexion internet est disponnible et qu'une nouvelle version est detectée, son telechargement est proposé.
Sans connexion internet disponnible depuis le PC d'installation de Lighty, il faut telecharger l'agent depuis un autre PC à l'aide de l'url fournie.
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.
L'onglet "Activity Viewer" permet de visualiser l'activité d'une base de données.
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
- 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 pouvez également 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.
Les boutons "Prev Day" et "Next Day" permettent de passer au jour précédent ou suivant en conservant la période horaire
La list "tags" permet de sélectionner une période enregistrée grace au bouton "tag"
.
Ces periodes ne sont pas supprimées lors de la purge reguliére des données, mais uniquement en utilisant le bouton 
2 - Filtrer les données
Le filtre de type champ vous permet de saisir un SQL ID ou un PID 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'é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 - 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 des statistiques (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. |
||
| SQLs Aggregate |
Affiche les SQLs regroupés par similarité (seuls les paramètres diffèrent) 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. L'aggregation des requêtes se fait avec une granularité de 5 minutes |
||
| 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.
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 | Version, Users, Extensions, Instance parameters, Databases, Schema... |
| Physical Design | Tablespace size... |
| DB Statistics | dba_cache_hit_ratio, dba_taille_objets, dba_taille_bytea, dba_fragmentation_table, dba_dependances_fk... |
| Sessions | pg_stat_activity... |
| SQLs | pg_stat_statements, top queries, running... |
| Segments / Tables | ... |
| Locks / Transactions | Blocking session... |
| Alert | TableSpace, FileSystemUsed... |
La navigation par lien hypertexte et l'affichage de l'historique de navigation rendent aisé le passage d'une information à une autre.
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 |
| Text de la requête |
| Les statistiques d'exécution |
L'Onglet Compare
Le but de ce nouvel onglet est d’améliorer la comparaison de deux sources de données
• 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.
Une fois sur l'onglet Compare vous pouvez choisir "Actual Source" ou le bouton "Import".
Les filtres ou les boutons permettant de faire varier la période restent opérationnels.
Alertes
Dans la partie "Reports", on trouve la section "Alert".
Les rapports de cette section sont appelés toutes les minutes.
Un rapport peut s’exécuter sur chaque base, ou bien au niveau du serveur en sélectionnant la bonne option dans le 1er onglet du SQL Wizard
Si un rapport retourne au moins une ligne, un email d'alerte est envoyé
On peut configurer le destinataire dans la fenêtre Tools / Options / Alert
Le serveur SMTP dans la fenêtre Tools / Options / Email
Cette section contient 2 sous-sections :
1 - Définition
Contient les requêtes qui vont servir à déclencher une alerte
Exemple :
On veut pouvoir être alerté lorsque le système de fichier qui abrite les TablesSpaces dépasse un certain pourcentage d'occupation.A l'aide du SQL Wizard, on va donc définir sous la section Alert / Definition un rapport qui aura la forme suivante :
SELECT 'FileSystemUsed' as "key",'File System Used ' || FSUse || '% > 40%' as "Alert" FROM ( SELECT (( p2.value::decimal / p.value::decimal)*100)::integer as FSUse FROM l_ash.parameters p,l_ash.parameters p2 WHERE p.name='filesys_size' AND p2.name='filesys_used' ) T WHERE FSUse > 40Si la taille occupée dépasse 40% de la capacité du disque abritant les données PostgreSQL, cette requête renverra une ligne de résultat.
Cette ligne doit être formatée de la manière suivante :
- champ contenant une clef d'identification de l'alerte (le nom de l'alerte, ou la concaténation du nom, de l'utilisateur...)
- champ contenant le texte de l'alerte
2 - List
Contient la requête Open qui liste les alertes actives, et la requête Closed qui liste les alertes terminées.Rapports
Dans la partie "Reports" se trouvent différents rapports mettant en avant les informations les plus pertinentes pour le travail des DBAs. Vous avez la possibilité de créer vos propres rapports personnalisés.
La liste des rapports est accessible via le menu Windows 
Ou bien via le menu Reports 
Il est possible d'exporter et d'importer un rapport personnalisé 
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 |
| 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
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.
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 
|
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  |