ログ ファイルのコンフィグレーションとログ メッセージのフィルタ処理
![]() |
![]() |
![]() |
![]() |
この章では、『ログ ファイルのコンフィグレーションとログ メッセージのフィルタ処理』の内容と構成について説明します。
このマニュアルでは、BEA WebLogic Server® ロギング サービスを使用して、サーバ、サブシステム、およびアプリケーション イベントをモニタする方法について説明します。また、ログ ファイルにメッセージを書き込み、WebLogic Server がブロードキャストするログ メッセージをリスンするように WebLogic Server をコンフィグレーションする方法、WebLogic Server Administration Console でログ メッセージを表示する方法についても説明します。
このマニュアルは、WebLogic ロギング サービスをコンフィグレーションし、サーバおよびサブシステムのイベントをモニタするシステム管理者、および J2EE アプリケーション ログを WebLogic Server ログに統合する J2EE アプリケーション開発者に情報を提供するものです。マニュアルの内容は、デプロイメントからテストおよびプロダクションまで、ソフトウェア プロジェクトのすべての段階に関連しています。
このマニュアルでは、アプリケーションのロギングまたはログ メッセージ カタログのローカライズおよびインターナショナライズは扱いません。これらのトピックに関する情報へのリンクについては、「関連マニュアル」を参照してください。
J2EE 技術、Web 技術、オブジェクト指向プログラミング技術、および Java プログラミング言語について読者が精通していることを前提としています。
BEA の Web サイトでは、WebLogic Server の全マニュアルが公開されています。Administration Console オンライン ヘルプの「ログの表示とコンフィグレーション」では、WebLogic Server インスタンスが生成するログ ファイルを表示およびコンフィグレーションする方法について説明します。『アプリケーション ロギングの WebLogic ロギング サービス ユーザーズ ガイド』では、WebLogic Server メッセージ カタログ、非カタログ ロギング、サーブレット ロギングを使用してアプリケーションまたはリモート Java クライアントからログ メッセージを生成する方法、およびログ メッセージのインターナショナライズとローカライズに対する WebLogic のサポートについて説明します。
このマニュアルの他にも、ロギングのコンフィグレーションや API の使い方を示すさまざまなロギング コードのサンプルやチュートリアルが用意されています。
MedRec は WebLogic Server に付属したエンドツーエンドのサンプル J2EE アプリケーションであり、一元的で独立した医療記録管理システムをシミュレートします。MedRec アプリケーションは、患者、医師、および管理者に対して、さまざまなクライアントを使用して患者のデータを管理するためのフレームワークを提供します。
MedRec では WebLogic Server と J2EE の機能が例示され、BEA 推奨のベスト プラクティスが重要点として示されます。MedRec は WebLogic Server 配布キットに含まれており、Windows マシンの [スタート] メニューからアクセスできます。Linux などのプラットフォームでは、WL_HOME
\samples\domains\medrec
ディレクトリから MedRec を起動します。WL_HOME
は、WebLogic Server の最上位のインストール ディレクトリです。
WebLogic Server とともにインストールされる MedRoc ドメインは、Log4j ロギングを有効にするようにコンフィグレーションされています。一部のアクション クラスと MedRec ユーティリティ クラスでは、weblogic.logging.log4j.Log4jLoggingHelper
クラスを使用して、新しいロガーの作成、Log4j アペンダへのアクセス、ロガーへのアペンダの登録が可能です。これにより、基本クラスを拡張するクラスは、ロガーを使用して情報メッセージを WebLogic Server ログ ファイルに書き込めます。
WebLogic Server 9.0 では、必要に応じて API サンプル コードを WL_HOME
\samples\server\examples\src\examples
にインストールできます。WL_HOME
は WebLogic Server の最上位のインストール ディレクトリを示します。[スタート] メニューの [WebLogic Server Examples] から、サンプル サーバを起動すると、サンプルおよびその実行手順に関する情報を確認できます。
WebLogic ロギング サービスには、以下の新しい機能とコンフィグレーション オプションがあります。
LogMBean インタフェースが改良されて、ロガーおよびハンドラに重大度しきい値レベルとフィルタを設定することにより、ロギングの出力を制御できるようになりました。
以前のバージョンの WebLogic Server では、システム管理者と開発者は、ロガーとハンドラにプログラム的なアクセスしかできませんでした。このリリースでは、MBean を使用してハンドラをコンフィグレーションできるので、最も基本的なロギング コンフィグレーションのコードを記述する必要はありません。Administration Console と WebLogic Scripting Tool (WLST) では、ロギング MBean とやりとりするためのインタフェースが提供されます。ロガーのコンフィグレーションには API のみを使用できます。
WebLogic Server は Jakarta Project Log4j をサポートしています。Administration Console で、Log4j またはデフォルトの Java ロギング実装を指定します。または、LogMBean インタフェースの LogMBean.isLog4jLoggingEnabled
属性を使用して、Log4j のロギングをコンフィグレーションできます。
Jakarta Commons Logging API は、ユーザを基底のログ実装から分離する抽象レイヤを提供しています。WebLogic Server には Commons LogFactory
インタフェースの実装が用意されており、この API を使用してサーバの Logger
にリクエストを発行できます。
logs
ディレクトリにある。たとえば、DOMAIN_NAME\
servers
\SERVER_NAME\
logs
\SERVER_NAME.
log
です。DOMAIN_NAME
はドメインを配置したディレクトリの名前、SERVER_NAME
はサーバの名前です。logs
ディレクトリにある。ドメイン ログ ファイルのデフォルトの名前と場所は、DOMAIN_NAME\
servers
\ADMIN_SERVER_NAME\
logs
\DOMAIN_NAME.
log
です。DOMAIN_NAME
はドメインを配置したディレクトリの名前、ADMIN_SERVER_NAME
は管理サーバの名前です。LogFileMBean
の LogFileRotationDir
プロパティを設定します。WebLogic Server ドメインでは、複数の MBean がロギング サービスをコンフィグレーションします。ロギング サブシステムには、新規の MBean または更新された MBean がいくつかあります。表 1-1 では、それらの MBean について説明し、図 1-1 にドメイン内の MBean を示します。
|
|
|
|
|
|
|
|
|
|
|
|
|
9.0 で非推奨および新規の MBean を含む完全なリストについては、『WebLogic Server MBean リファレンス』を参照してください。
![]() ![]() |
![]() |
![]() |