Guide de l'Utilisateur Lighty PostgreSQL

---

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

---

Fênetre 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, cachées. Certaines peuvent être maximisées en double cliquant sur la barre de titre ou 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 permet via une page unique de vous offrir un aperçu de différentes statistiques d’activité. 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. Reduisez/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.

---

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 dispobiles. Ils sont de couleur bleue.

---

Dans l'écran de 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

---

Composants Timeline

Ce composant vous informe visuellement de l'activité d'un identifiant dans une fourchette de temps.

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é

Rafraichissements automatiques

De nombreux écrans proposent un possible rafraichissement des informations affichées.
Dans ce cas, les boutons vous permettent de gérer ce rafraichissement.
Pour un rafraichissement automatique, sélectionnez la case à cocher puis la fréquence dans la liste (10s, 30s ou 60s). Un décompte est affiché.
Pour un rafraichissement 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é 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 leur 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éfinisez 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 chaine 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

---

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 connection.

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 connection.

La retention et la version de l'agent sont accessible via les boutons ci-dessous

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'interoger la base Lighty pour recuperer la version utilisée par l'agent installé, ainsi que le site Lighty Software pour obtenir la derniere version disponnible.

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 Connections

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 connections 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 vous aider à 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écedent ou suivant en conservant la période horaire

La list "tags" permet de selectionner une periode 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

Celle-ci se fait à l'aide de la souris. Sélectionnez une partie du graphique pour 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 de la statistique (Machine, programme, utilisateur ...)
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 Informations	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 ...

---

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 pour effectuer une recherche manuelle.

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.
        • Nous pouvons 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.

Si un rapport SQL retourne au moins une ligne, un email d'alerte est envoyé Cette section contient 2 sous sections :

1 - Definition

contient les requêtes qui vont servir à declencher 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 SqlWizard, on va donc definir 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 > 40
							

Si 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éré 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 va lister les alertes actives et la requête Closed, qui liste les alertes terminées.

---

Rapports

---

Dans la partie "Reports", nous avons différents rapports mettant en avant les informations les plus pertinnentes pour le travail des DBAs . Vous avez la possibilité de crée 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.

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 base de données entre les logiciels Lighty

---

Killer une session

---

Vous pouvez killer 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 Wizzard

---

Le SQL Report Wizzard permet aussi de dupliquer ou de modifier des rapports déjà existants. La fonction « Duplicate » a été conçu afin de créer des rapports personnalisés avec pour base des rapports existants. Ainsi un utilisateur lambda pourra définir ces propres rapports sans pour autant modifier l’existant. Ceci 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 qu’un rapport que l’on a précédemment ajouter.
Les rapports par défaut contenu dans Lighty ne sont par conséquent ni modifiables, ni supprimables.

---

SQL Report Wizzard

---

Le SQL Report Wizzard est un outil permettant de créer ces 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 qu’un rapport que l’on a précédemment ajouter.
Les rapports par défaut contenu 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	...

Puis cocher les cases d’options :

Refreshable

Le rapport sera rafraichi périodiquement, la période peut être configurable

Il faut ensuite définir le type de la requête :



Une requête parent sera rattachée à une catégorie à sélectionner dans la liste :



Le rapport apparaitra alors dans l’arborescence de la catégorie ainsi que dans la catégorie My Report.
Attention si un jour vous supprimer la catégorie choisie vous supprimer toutes les requêtes associées.
Une requête child n’est quant à elle rattachée à aucune catégorie, elle sera flottante dans l’arboresence. Sauf si on la rattache à un groupe existant et 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 on pourra alors 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édier puis cliquer sur Modify.



Pour ajouter une ligne, il faut cliquer sur Add, les valeurs sélectionnées dans les listes sont alors utiliser 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 apparaitre 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 correspondra à la plage sélectionnée sur l’écran précèdent.



La valeur des paramètres éventuels de la requête sont représentés 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 succedeed est affichée.

4 - Columns Définitions

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 rafraichie périodiquement)
Virtual	Indique si la valeur de la colonne sera calculée en fonction de 2 colonnes (voir écran Virtuals 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 defaut vers d’autre fenêtre. Exemple : Pour le type Sid (Session Id), un clic sur la valeur permet d’ouvir 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 afficher 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 des 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.

6 - 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 :

7 - 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, lors de l’appui sur une colonne dont le nom est défini dans le champ Column Linked.

Cela signifie que, si un autre rapport à une colonne de ce 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ètre issu 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 : va afficher 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.

8 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 YesNo, 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éfini 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 rajouté
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

9 - Validate the new SQL

Cet écran permet de valider le rapport en appuyant sur le bouton Finish.