Activer la journalisation des requêtes

Pour activer la journalisation des requêtes pour un cube Essbase, créez un fichier de paramètres de journalisation des requêtes dans le répertoire du cube, configurez-le et redémarrez le cube. Les entrées de journal sont écrites dans un fichier .qlg du journal des requêtes, que vous pouvez enregistrer et visualiser au format xml.

Les étapes suivantes expliquent comment créer un fichier de paramètres de journal des requêtes. Pour consulter un exemple de fichier journal de requête, reportez-vous à Exemple de fichier de journalisation de requête.

Pour activer la journalisation des requêtes :

1. Dans le répertoire de cube, créez un fichier de paramètres de journal des requêtes.

   Le fichier de paramètres doit être nommé dbname.cfg, où dbname correspond au nom du cube. Par exemple, le fichier de paramètres du journal des requêtes pour Sample Basic est basic.cfg. Comme les applications Essbase 21c sont en mode Unicode, vous devez utiliser un éditeur de texte compatible UTF-8 et enregistrer en tant qu'UTF-8 avec BOM.

   Remarques :

   Le répertoire de cube signifie <Application Directory>/app/appname/dbname. Si vous ne savez pas où trouver <Application Directory> dans votre environnement,

   • Reportez-vous à la section Emplacements d'environnement dans la plate-forme Essbase si vous utilisez un déploiement Essbase indépendant.

   • Si vous utilisez un déploiement Essbase sur Oracle Cloud Infrastructure Marketplace, <Application Directory> est /u01/data/essbase/app.

2. Dans le fichier de paramètres, indiquez les éléments requis et facultatifs à l'aide de la syntaxe de la section Syntaxe de journalisation des requêtes :

   • Dimension pour laquelle vous voulez consigner les requêtes (QUERYLOG [dimension_name]).

   • Facultatif : paramètre permettant de consigner les numéros de génération ou de niveau des membres des générations ou niveaux spécifiés dans une dimension (QUERYLOG GENERATION generation-range ou QUERYLOG LEVEL level-range).

   • Facultatif : paramètre permettant d'exclure la journalisation des membres des générations ou niveaux spécifiés dans une dimension (QUERYLOG NONE GENERATION generation-range ou QUERYLOG NONE LEVEL level-range).

   • Facultatif : emplacement où le fichier journal des requêtes est créé (QUERYLOG LOGPATH path-expression).

   • Facultatif : format de la sortie du fichier journal (QUERYLOG LOGFORMAT CLUSTER | TUPLE).

   • Facultatif : taille du fichier journal (QUERYLOG LOGFILESIZE n)

   • Facultatif : taille de tous les fichiers journaux (QUERYLOG TOTALLOGFILESIZE n).

   • Paramètre permettant d'activer ou de désactiver la journalisation des requêtes au prochain démarrage de l'application (QUERYLOG ON | OFF).

3. Redémarrez le cube pour accepter les paramètres.

   Remarques :

   Redémarrez après avoir créé un fichier ou modifié les entrées d'un fichier.

4. Une fois la journalisation des requêtes activée, vérifiez les entrées de journal dans le fichier journal des requêtes, dbname.qlg.

   Par exemple, vous pouvez afficher la sortie du fichier journal pour analyser le nombre d'interrogations effectuées sur un membre donné. Utilisez un éditeur compatible UTF-8 pour afficher les fichiers journaux.