ロギングおよびトレースのプロパティーの説明

pureQuery は、構成可能な重大度レベルを持つロギング機能およびトレース機能を提供します。 これにより、ユーザーは、出力のタイプを制御することができます。

以下の 2 つのプロパティーを設定できます。

pdq.traceFile
ログを書き込む物理ファイルを指定します。絶対パス、または pureQuery ログ・ユーティリティーを実行するディレクトリーに対する相対パスを使用できます。
ファイルがすでに存在する場合、pureQuery は新しいログ項目のためにこのファイルを使用する前に、このファイルの内容を削除します。
pdq.traceLevel
ログ・ファイルに書き込む詳細情報のレベルを指定します。レベルは、最も情報の少ないレベルから最も詳細なレベルの順に、以下のようになっています。
  • OFF
  • SEVERE
  • WARNING
  • INFO
  • CONFIG
  • FINE
  • FINER
  • FINEST
  • ALL
デフォルトのレベルは OFF です。

com.ibm.pdq ロガーのトレース・レベルが INFO より包括的なレベルに設定されていて、pureQuery プロパティーでは com.ibm.pdq ロガーのトレース・レベルより包括的なレベルが設定されていない場合には、pureQuery は com.ibm.pdq ロガーのレベルを継承します。

pureQuery アプリケーションと一緒に WebSphere® Application Server を使用する計画の場合に、WebSphere Application Server のログ内で pureQuery ログ項目を参照するのであれば、INFO より上位のレベルに設定する必要があります。

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

getJccSpecialRegisterProperties() メソッドに対する呼び出しの結果のロギング

アプリケーションが IBM® Data Server Driver for JDBC and SQLJ を使用して、サポートされている DB2® データベースに接続する際に、Connection オブジェクト上の getJccSpecialRegisterProperties() メソッドを呼び出す場合は、pureQuery はオブジェクト上のこのメソッドに対する最初の呼び出しの結果をログに記録できます。pureQuery がログに書き込むメッセージには、ドライバーがデータベース用にサポートする特殊レジスターの非ヌル値がすべてリストされます。

ログ内のこのメッセージを参照するには、トレース・レベルを FINE に設定します。


フィードバック