TRACE_REPORT
Utilisez le paramètre de configuration TRACE_REPORT pour déboguer les performances de plusieurs requêtes simultanées. La fonction de trace des requêtes vous aide à surveiller les mesures de performances des requêtes Essbase. Le niveau d'informations à conserver est indiqué dans le journal de l'application et/ou dans un journal de trace distinct, trace_report.log.
Description
TRACE_REPORT active la fonction de trace des requêtes pour les extractions de grille, les requêtes MDX et les sources de partition transparentes. Le fichier de sortie du suivi des requêtes contient des informations sur :
-
Type de requête
-
Heure de la requête
-
Nom d'utilisateur et adresse IP
-
Texte du rapport
Syntaxe
TRACE_REPORT noù n doit être défini sur -1, pour activer la fonction de trace des requêtes. La valeur par défaut est 0 (la fonction de trace des requêtes est désactivée).
Remarques :
Le support technique Oracle peut définir une valeur entière différente de zéro pour réduire les éléments consignés danstrace_report.log.
Exemple
TRACE_REPORT -1Configuration de la fonction de trace des requêtes en cours
Utilisez ensemble les paramètres de configuration TRACE_REPORT et LONGQUERYTIMETHRESHOLD pour gérer les informations de trace de requête qui doivent être collectées pour le cube dans le journal Oracle Diagnostic Log (ODL) de l'application et/ou imprimées dans trace_report.log.
Vous pouvez activer TRACE_REPORT pour le suivi des performances générales des requêtes, mais Oracle recommande de filtrer toutes les requêtes en cours d'exécution, sauf les requêtes les plus longues, en définissant également LONGQUERYTIMETHRESHOLD.
- Configurez Essbase pour consigner uniquement les informations relatives aux 5 % de requêtes les plus longues. Si vous ne connaissez pas cette valeur, 60 secondes peuvent être un bon point de départ.
- Vérifiez régulièrement que les fichiers journaux ne sont pas trop volumineux.
| Type de configuration | Valeur TRACE_REPORT | Valeur LONGQUERYTIMETHRESHOLD | Effet sur les journaux |
|---|---|---|---|
| ODL uniquement, avec seuil | Défini sur 0 (ou pas du tout défini) | Définir sur une valeur n (secondes) supérieure à 0 | Les mesures de performances de toutes les requêtes exécutées pendant plus de n secondes sont affichées dans le journal ODL de l'application. |
| ODL et trace, avec seuil | Définir sur -1 | Définir sur une valeur n (secondes) supérieure à 0 | Les mesures de performances de toutes les requêtes exécutées pendant plus de n secondes sont imprimées dans le journal ODL de l'application.
Les informations sur les requêtes s'exécutant plus de n secondes sont affichées dans |
| Trace sans seuil - déconseillé | Définir sur -1 | Défini sur 0 (ou pas du tout défini) | Les informations sur toutes les requêtes, quelle que soit la durée d'exécution, sont affichées dans trace_report.log.
Cette configuration n'est pas recommandée, car |
Le journal trace_report se trouve dans <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<cube-name>/trace_report.log.
Le journal ODL de l'application se trouve dans <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<application-name>_ODL.log.
Pour plus d'informations sur les emplacements des fichiers journaux, reportez-vous à la section Environment Locations in the Essbase Platform.
Quand utiliser différentes options de trace de requête
Le paramètre de configuration QUERYTRACE est conçu pour le débogage d'une requête unique, en cas de problème. Il imprime le journal de trace dans le répertoire de cube en tant que query_trace.txt, et le fichier est effacé par défaut avant chaque exécution de requête. La fonction QUERYTRACE ne doit pas être activée dans la configuration de l'application pour une utilisation à long terme, car elle peut affecter les performances.
Le paramètre de configuration TRACE_REPORT fournit moins de détails que QUERYTRACE, mais il permet de suivre plusieurs requêtes simultanées. TRACE_REPORT est une bonne option pour collecter des informations sur de nombreuses requêtes simultanées exécutées sur une période donnée.
L'activation de la journalisation des requêtes en définissant le paramètre QUERYLOG dans dbname.cfg (dans le répertoire de cube) est conçue pour le suivi des modèles de requête utilisateur pour un cube, au format XML.
Remarques
TRACE_REPORT s'applique aux bases de données en mode "block storage", y compris celles en mode hybride. TRACE_REPORT ne s'applique pas aux bases de données en mode "aggregate storage" (ASO).