LONGQUERYTIMETHRESHOLD
Le paramètre de configuration LONGQUERYTIMETHRESHOLD vous permet de capturer des statistiques sur les requêtes MDX et la grille Essbase à longue durée d'exécution. Indiquez la durée de requête la moins longue (en secondes) pour laquelle vous voulez capturer des informations statistiques.
- récapitule brièvement les performances des requêtes dans le journal Oracle Diagnostic Log (ODL) pour chaque requête exécutée plus longtemps que la valeur de temps indiquée
- définit un seuil/filtre sur ce qui est consigné pour la fonction de trace des requêtes (lorsque le paramètre TRACE_REPORT est activé)
Syntaxe
LONGQUERYTIMETHRESHOLD noù n représente un nombre de secondes. Si la valeur est définie sur 0, ce paramètre est désactivé (il s'agit de la valeur par défaut). Si la valeur est -1, ce paramètre est toujours activé.
Exemple
LONGQUERYTIMETHRESHOLD 60Spécifie la collecte de statistiques pour les requêtes exécutées pendant 60 secondes ou plus.
Configuration 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.