LONGQUERYTIMETHRESHOLD

Mit der Konfigurationseinstellung LONGQUERYTIMETHRESHOLD können Sie Statistiken zu Essbase-Raster- und MDX-Abfragen mit langer Ausführungszeit erfassen. Geben Sie die geringste Abfragedauer in Sekunden an, für die Sie statistische Informationen erfassen möchten.

Wenn Sie LONGQUERYTIMETHRESHOLD aktivieren, Essbase:
  • fasst die Abfrage-Performance in Oracle Diagnostic Log (ODL) für jede Abfrage kurz zusammen, die länger als der angegebene Zeitwert ausgeführt wird
  • Legt einen Schwellenwert/Filter für das Protokoll für das Abfragetracing fest (wenn die Einstellung TRACE_REPORT aktiviert ist)

Syntax

LONGQUERYTIMETHRESHOLD n

wobei n eine Anzahl von Sekunden ist. Wenn dieser Wert auf 0 gesetzt ist, ist diese Einstellung deaktiviert (Standard). Bei -1 ist diese Einstellung immer aktiviert.

Beispiel

LONGQUERYTIMETHRESHOLD 60

Gibt die Statistiksammlung für Abfragen an, die 60 Sekunden oder länger ausgeführt werden.

Laufendes Abfrage-Tracing konfigurieren

Verwenden Sie die Konfigurationseinstellungen TRACE_REPORT und LONGQUERYTIMETHRESHOLD, um die Abfrage-Tracing-Informationen zu verwalten, die für den Cube im Oracle Diagnostic Log (ODL) der Anwendung erfasst und/oder an trace_report.log gedruckt werden sollen.

Sie können TRACE_REPORT für die Verfolgung der allgemeinen Abfrageperformance aktivieren. Oracle empfiehlt jedoch, alle Abfragen außer den Abfragen mit der längsten Ausführungszeit herauszufiltern, indem Sie auch LONGQUERYTIMETHRESHOLD festlegen.

Idealerweise
  • Konfigurieren Sie Essbase so, dass nur Informationen für die Top 5 Prozent der Abfragen mit der längsten Ausführungszeit protokolliert werden. Wenn Sie diesen Wert nicht kennen, können 60 Sekunden ein guter Anfang sein.
  • Prüfen Sie regelmäßig, ob die Logdateien nicht zu groß werden.
Konfigurationstyp TRACE_REPORT-Wert LONGQUERYTIMETHRESHOLD-Wert Auswirkung auf Protokolle
Nur ODL mit Schwellenwert Auf 0 (oder gar nicht festgelegt) setzen Setzen Sie den Wert n (Sekunden), der größer als 0 ist Performancemetriken für alle Abfragen, die länger als n Sekunden ausgeführt werden, werden im ODL-Log der Anwendung gedruckt.
ODL und Trace mit Schwellenwert Festgelegt auf -1 Setzen Sie den Wert n (Sekunden), der größer als 0 ist Performancemetriken für alle Abfragen, die länger als n Sekunden ausgeführt werden, werden in das Anwendungs-ODL-Log gedruckt.

Informationen zu Abfragen, die länger als n Sekunden ausgeführt werden, werden an trace_report.log ausgegeben.

Trace ohne Schwellenwert - nicht empfohlen! Festgelegt auf -1 Auf 0 (oder gar nicht festgelegt) setzen Informationen zu allen Abfragen, unabhängig von der Laufzeit, werden an trace_report.log gedruckt.

Diese Konfiguration wird nicht empfohlen, da trace_report.log zu groß werden kann, wenn es nicht mit einem Schwellenwert gefiltert wird, und die Abfrageperformance beeinträchtigt wird, wenn der Schwellenwert zu niedrig ist.

Das trace_report-Log befindet sich in <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<cube-name>/trace_report.log.

Das ODL-Log der Anwendung befindet sich in <Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<application-name>_ODL.log.

Einzelheiten zu den Speicherorten von Logdateien finden Sie unter Speicherorte von Umgebungen in der Essbase-Plattform.

Wann verschiedene Abfrage-Tracing-Optionen verwendet werden sollten

Die Konfigurationseinstellung QUERYTRACE dient zum Debuggen einer einzelnen Abfrage, falls Probleme auftreten. Das Trace-Log wird als query_trace.txt in das Cube-Verzeichnis gedruckt, und die Datei wird vor jeder Abfrageausführung standardmäßig gelöscht. QUERYTRACE darf in der Anwendungskonfiguration nicht für eine langfristige Verwendung aktiviert bleiben, da dies die Performance beeinträchtigen kann.

Die Konfigurationseinstellung TRACE_REPORT enthält weniger Details als QUERYTRACE, kann jedoch mehrere gleichzeitige Abfragen verfolgen. TRACE_REPORT ist eine gute Option zum Sammeln von Informationen zu vielen gleichzeitigen Abfragen, die über einen bestimmten Zeitraum ausgeführt werden.

Die Aktivierung des Abfrage-Loggings durch Einstellen des QUERYLOG-Parameters in dbname.cfg (im Cube-Verzeichnis) dient zur Verfolgung von Benutzerabfragemustern für einen Cube im XML-Format.