java.util.logging -- Java ロギング・プログラミング・インターフェース

java.util.logging.Logger クラスは、データをログに記録できるメソッドを複数提供しています。

WebSphere® Application Server では、基本のログおよびトレース・モードを使用している場合、Java™ ロギング API (java.util.logging) によって、WsLevel.DETAIL レベルまたはそれ以上 (WsLevel.DETAIL、Level.CONFIG、Level.INFO、WsLevel.AUDIT、Level.WARNING、Level.SEVERE、および WsLevel.FATAL を含む) でログに記録されるイベント用の Common Base Event が自動的に作成されます。 これらの Common Base Event は、メッセージの記録先となるロガーに関連付けされたイベント・ファクトリーを使用して作成されます。 どのイベント・ファクトリーも指定されていない場合、WebSphere Application Server は、WebSphere Application Server 固有 の情報を自動入力するデフォルトのイベント・ファクトリーを使用します。

WebSphere Application Server は、以下の メソッドのための Common Base Event を自動的に作成する java.util.logging.Logger クラスの 特殊な実装を使用します。
  • config
  • info
  • warning
  • severe
  • log: WsLevel.DETAIL レベルまたはより制限の多いレベルで使用された場合の、log(LogRecord) 以外のすべてのバリアント
  • logp: WsLevel.DETAIL レベルまたはより制限の多いレベルで使用された場合
  • logrb: WsLevel.DETAIL レベルまたはより制限の多いレベルで使用された場合
WebSphere Application Server のロガー実装は、名前付きロガー、例えば、Logger.getLogger("com.xyz.SomeLoggerName") のような呼び出しを使用して インスタンス化されたロガーのみに使用されます。Logger.getAnonymousLogger と Logger.getLogger、または Logger.global メソッドへの 呼び出しによってインスタンス化されたロガーでは、WebSphere Application Server の実装は使用されず、 それら自体に対して行われる要求をロギングするための Common Base Event も自動的に作成されません。 Logger.log(LogRecord) メソッドによって直接ログが記録されるログ・レコード は、WebSphere Application Server のロガーによって Common Base Event へ自動変換されません。

次の図は、アプリケーション・コードがどのようにして Common Base Events がログに記録されるのかを示しています。

アプリケーション・コードによるログへの CBE の記録方法

名前付きロガーおよびメッセージ・レベル・イベントの Java ロギング API の処理は、 以下のとおりに進められます。
  1. アプリケーション・コードが、名前付きロガー (WsLevel.DETAIL またはそれ以降) を、イベント固有のデータを用いて呼び出します。
  2. ロガーが、そのロガーに関連したイベント・ファクトリーの createCommonBaseEvent メソッドを使用して、Common Base Event を作成します。
  3. ロガーが、そのロガーに関連したイベント・ファクトリーを使用して Common Base Event を作成します。
  4. ロガーが、CommonBaseEventLogRecord レコード内に Common Base Event をラップし、イベント固有のデータを追加します。
  5. ロガーが、Common Base Event の complete メソッドを呼び出します。
  6. Common Base Event が、ContentHandler の completeEvent メソッドを呼び出します。
  7. コンテンツ・ハンドラーが、XML テンプレート・データを Common Base Event へ追加します (例えば、コンポーネント名など)。 すべてのコンテンツ・ハンドラーがテンプレートをサポートするわけではありません。
  8. コンテンツ・ハンドラーが、ランタイム・データを Common Base Event へ追加します (例えば、現行スレッド名など)。
  9. ロガーが、CommonBaseEventLogRecord レコードをハンドラーに受け渡します。
  10. ハンドラーがデータをフォーマットし、出力装置に書き込みます。

トピックのタイプを示すアイコン 参照トピック



タイム・スタンプ・アイコン 最終更新: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rtrb_cbejavaapi
ファイル名:rtrb_cbejavaapi.html