TRACE_REPORT

Verwenden Sie die Konfigurationseinstellung TRACE_REPORT, um die Performance für mehrere gleichzeitige Abfragen zu debuggen. Mit dem Abfragetracing können Sie Essbase-Abfragemetriken überwachen. Die Informationsebene, die Sie beibehalten möchten, wird im Anwendungslog und/oder in einem separaten Tracinglog, trace_report.log, gemeldet.

Beschreibung

TRACE_REPORT ermöglicht das Abfrage-Tracing für Rasterabrufe, MDX-Abfragen und transparente Partitionsquellen. Die Ausgabedatei für das Tracing von Abfragen enthält Informationen zu:

  • Abfragetyp

  • Zeitpunkt der Abfrage

  • Benutzername und IP-Adresse

  • Berichtstext

Syntax

TRACE_REPORT n

wobei n auf -1 gesetzt werden muss, um das Abfragetracing zu aktivieren. Der Standardwert ist 0 (Abfrage-Tracing ist deaktiviert).

Hinweis:

Oracle Support kann einen anderen Ganzzahlwert ungleich Null festlegen, um die in trace_report.log protokollierten Elemente zu reduzieren.

Beispiel

TRACE_REPORT -1

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) gesetzt 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) gesetzt 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.

Hinweise:

TRACE_REPORT gilt für Block Storage-(BSO-)Datenbanken, einschließlich Datenbanken im Hybridmodus. TRACE_REPORT gilt nicht für Aggregate Storage-(ASO-)Datenbanken.

Siehe auch

LONGQUERYTIMETHRESHOLD

QUERYTRACETHRESHOLD

QUERYTRACE