1 アプリケーション・ロギングおよびWebLogicロギング・サービス
WebLogicロギング・サービスについて
アプリケーションにとって利点となり得るWebLogicロギング・サービスの2つの特徴は、拡張性と国際化のサポートです。
独自のログ・メッセージ・カタログを作成し、WebLogicユーティリティによって、アプリケーション・コードで使用できるJavaクラスを生成できます。アプリケーションから生成されたログ・メッセージは、サーバーによって生成されたログ・メッセージと統合され、同じように扱われます。WebLogic Serverログへのメッセージの書込みを参照してください。
作成するログ・メッセージ・カタログは、任意の言語で記述でき、これに様々なロケール用の翻訳を付けることができます。WebLogicにおける国際化のサポートにより、WebLogic Serverが実行されている現在のロケール向けの適切な言語で記述されたログ・メッセージが存在できるようになります。WebLogic Serverの国際化およびローカライゼーションを参照してください。
アプリケーション・ロギングを、WebLogicロギング・フレームワークに統合することで得られる主なメリットは、管理がしやすくなることです。WebLogic Server管理コンソールを使用して、すべてのログ・ファイルおよび関連オプションを管理できます。詳細は、Oracle WebLogic Server管理コンソール・オンライン・ヘルプのログの表示と構成を参照してください。
アプリケーション・ロギングとWebLogicロギング・サービスの統合: 主なステップ
-
WebLogicツールを使用してカスタム・ログ・メッセージ・カタログおよび関連のJava APIをビルドします。アプリケーションは、これらのインタフェースによって公開されたログ・メソッドを呼び出して、ログ・メッセージを生成できます。メッセージ・カタログは、簡単に国際化できます。「WebLogic Serverでのメッセージ・カタログの使用方法」を参照してください。
-
WebLogicの非カタログ・ロガーを使用して、ログ・メッセージを生成します。カタログからメッセージを呼び出すかわりに
NonCatalogLogger
を使用することで、メッセージ・テキストをアプリケーション・コードに直接配置します。「NonCatalogLogger APIの使用」を参照してください。 -
javax.servlet.ServletContext
においてサーブレットおよびJSPで利用可能なlog()
メソッドを使用します。「ServletContextの使用」を参照してください。
WebLogicメッセージ・カタログ、NonCatalogLogger
、またはサーブレット・ロギングを使用しないアプリケーション開発者には、以下のことが可能です。
-
Java Logging APIを使用して、メッセージを生成および配信します。
-
Log4Jを使用してメッセージを生成し、Log4jまたはデフォルトのJavaロギングを使用してメッセージを配信するようサーバーを構成します。
-
Commons APIを使用してメッセージを生成します。
http://jakarta.apache.org/commons/logging/api/index.html
の「org.apache.commons.logging」を参照してください。 -
サーバー・ロギング・ブリッジのハンドラ(Javaロギングの場合)またはアペンダ(Log4jの場合)を使用します。これにより、アプリケーションのログ・メッセージがWebLogicロギング・サービスにリダイレクトされます。
ノート:
Javaロギングの代替としてWebLogicロギング・サービスでLog4jを使用することは、WebLogic Server 12.1.3では非推奨です。WebLogic Serverロガーへのアクセス
WebLogicロギング・インフラストラクチャでは、独自のアプリケーションおよびサブシステムによって生成されたログ・イベントを収集するロガーを、各サーバー上でサポートしています。WebLogic Serverは、管理サーバー上のドメイン・ロガーだけでなく、各サーバー上のロガーへの直接アクセスもサポートしています。
デフォルトでは、WebLogicロギング・サービスはJava Logging APIに基づいた実装を使用しています。LoggingHelper
クラスを使用すると、サーバー・ロギング用のjava.util.logging.Logger
オブジェクトへのアクセスが可能になります。「LoggingHelper」Javadocを参照してください。
別の方法としては、Java Loggingのかわりに、WebLogicロギング・サービスでLog4jを使用することもできます。Log4jが有効化されていると、weblogic.logging.log4j.Log4jLoggingHelper
クラスから、サーバーが使用しているorg.apache.log4j.Logger
への参照を取得できます。Log4j Logger
参照により、独自のカスタム・アペンダ(ハンドラ)をアタッチしてログ・イベントを受け取ったり、Logger
参照を使用してWebLogicロギング・サービスにログ・リクエストを発行したりすることができます。Log4jLoggingHelper
のJavadocを参照してください。
ノート:
Javaロギングの代替としてWebLogicロギング・サービスでLog4jを使用することは、WebLogic Server 12.1.3では非推奨です。加えて、WebLogicロギング・サービスでは、Jakarta Commons LogFactory
およびLog
インタフェースも提供しているので、Commons APIに対するプログラミングを行って、ログ・メッセージをサーバー・ログ・ファイルまたは登録されている任意の宛先に送ることができます。このAPIにより抽象化が行われ、基底のロギング実装(Log4jまたはJava Logging)に直に触れなくて済みます。
『Oracle WebLogic Serverログ・ファイルの構成とログ・メッセージのフィルタリング』のサーバー・ロギング・ブリッジに関する項を参照してください。
詳細(例を含む)は、Oracle WebLogic Serverログ・ファイルの構成とログ・メッセージのフィルタリングの次の項を参照してください。