pureQuery でのロギングおよびトレース

pureQuery は、構成可能な重大度レベルでロギングおよびトレース機能を提供し、ユーザーが出力のタイプを制御できるようにします。 ロギングおよびトレースは各レベルで必要な情報を提供し、実行時あるいは pureQuery ユーティリティーのいずれかを使用する際に問題判別をサポートします。

pureQuery ロギングは java.util.logging フレームワークを利用します。 そのフレームワーク内で、pureQuery はその親ロガー com.ibm.pdq.logger の名前を指定します。 Java ロギング API 規則およびツールを使用して、ユーザーおよびアプリケーションは、com.ibm.pdq logger に対してログ・レベルおよびログ・ファイルを設定し、pureQuery ログ・メッセージがこのロガーに転送されるようにすることができます。

WebSphere Application Server 6.1 などの、java.util.logging フレームワークでロガーを構成するための管理ツールを提供するアプリケーション・サーバーでは、pureQuery ロギングおよびトレースを制御するように com.ibm.pdq.logger を構成することができます。 こうした構成は、pureQuery プロパティーを使用して pureQuery ロギングを構成する方法の代わりとなります。pureQuery が com.ibm.pdq.logger レベルを使用するのは、それが pureQuery の pdq.traceLevel プロパティーで指定されたレベルおよび INFO よりも高い場合です。WebSphere Application Server Integrated Solutions Console では、「トラブルシューティング (Troubleshooting)」 > 「ログおよびトレース (Logs and Trace)」を選択することによって、com.ibm.pdq logger レベルを設定することができます。

pureQuery では、ロギングと JDBC ドライバー・ログが明示的に統合されることはありません。 ただし、Java ロギング API も使用してログに記録する JDBC ドライバーは、ロギング・フレームワークの統合に加わります。 つまり、JDBC ドライバーが Java ロギング・フレームワークも使用し、どちらのロガーも同じターゲットに書き込むように構成されている場合のみ、pureQuery および JDBC ドライバー・ログのエントリーは同じログにインターリーブされます。

ロギングが pureQuery 用に構成されている場合、pureQuery の下で実行される JDBC アプリケーションで発生する例外は pureQuery ログ・ファイルに示されます。JDBC ドライバー・ログが構成されている場合、一部の pureQuery エントリーは、JDBC ドライバー・ログにも示される場合があります。


フィードバック