TRACE_REPORT

TRACE_REPORT構成設定を使用して、複数の同時問合せのパフォーマンスをデバッグします。問合せトレースは、Essbase問合せのパフォーマンス・メトリックのモニターに役立ちます。保持する情報のレベルは、アプリケーション・ログまたは別のトレース・ログ(あるいはその両方)、trace_report.logにレポートされます。

説明

TRACE_REPORTは、グリッドの取得、MDX問合せおよび透過パーティションのソースの問合せトレースを有効にします。問合せトレースの出力ファイルには次に関する情報が含まれています:

問合せタイプ
問合せの時間
ユーザー名およびIPアドレス
レポート・テキスト

構文

TRACE_REPORT n

nは、問合せトレースを有効にする場合、-1に設定する必要があります。デフォルト値は0 (問合せトレースはオフ)です。

ノート:

Oracleサポートによって、trace_report.logに記録される項目を減らすために別のゼロ以外の整数値が設定される場合があります。

例

TRACE_REPORT -1

進行中の問合せトレースの構成

アプリケーションのOracle診断ログ(ODL)でキューブについて収集する必要がある問合せトレース情報、またはtrace_report.logに出力する必要がある問合せトレース情報(あるいはその両方)を管理するには、構成設定TRACE_REPORTおよびLONGQUERYTIMETHRESHOLDを併用します。

TRACE_REPORTを有効にすると一般的な問合せのパフォーマンスを追跡できますが、LONGQUERYTIMETHRESHOLDも設定することで、最長実行問合せを除くすべてをフィルタ処理することをお薦めします。

次のようにするのが理想的です。

最長実行問合せの上位5%についてのみ情報をログに記録するようにEssbaseを構成します。この値がわからない場合は、60秒から始めることをお薦めします。
ログ・ファイルが大きくなりすぎていないことを定期的に確認します。

構成タイプ	TRACE_REPORT値	LONGQUERYTIMETHRESHOLD値	ログへの影響
ODLのみ(しきい値あり)	0に設定(またはまったく設定しない)	0より大きい値n (秒)に設定	n秒より長く実行されているすべての問合せについてのパフォーマンス・メトリックがアプリケーションのODLログに出力されます。
ODLとトレース(しきい値あり)	-1に設定	0より大きい値n (秒)に設定	n秒より長く実行されているすべての問合せについてのパフォーマンス・メトリックがアプリケーションのODLログに出力されます。 n秒より長く実行されている問合せについての情報が`trace_report.log`に出力されます。
しきい値なしでトレース - お薦めしません	-1に設定	0に設定(またはまったく設定しない)	実行時間に関係なくすべての問合せについての情報が`trace_report.log`に出力されます。この構成はお薦めしません。これは、しきい値を使用してフィルタ処理しないと`trace_report.log`が大きくなりすぎ、しきい値が小さすぎると問合せパフォーマンスに影響するためです。

trace_reportログは、<Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<cube-name>/trace_report.logにあります。

アプリケーションのODLログは、<Domain Home>/servers/<Essbase-Managed-Server-Name>/logs/essbase/essbase/app/<application-name>/<application-name>_ODL.logにあります。

ログ・ファイルの場所の詳細は、Essbaseプラットフォームでの環境の場所を参照してください。

異なる問合せトレース・オプションを使用するタイミング

QUERYTRACE構成設定は、問題が確認された場合に単一の問合せのデバッグのために設計されています。トレース・ログをキューブ・ディレクトリにquery_trace.txtとして出力し、このファイルは、デフォルトで、各問合せの実行前にクリアされます。パフォーマンスに影響を及ぼす可能性があるため、QUERYTRACEは、長時間使用するためにアプリケーション構成で有効にしたままにしないでください。

TRACE_REPORT構成設定で提供する詳細は、QUERYTRACEよりも少なくなりますが、この構成設定は複数の同時問合せをトレースできます。TRACE_REPORTは、一定期間実行する多数の同時問合せについて情報を収集するために役立ちます。

dbname.cfg (キューブ・ディレクトリ内)でQUERYLOGパラメータを設定することで問合せロギングを有効にすると、キューブのユーザー問合せパラメータの追跡用に設計されています(XML形式)。

ノート

TRACE_REPORTは、ブロック・ストレージ(BSO)データベース(ハイブリッド・モードのデータベースを含む)に適用されます。TRACE_REPORTは、集約ストレージ(ASO)データベースには適用されません。