ロギングについて

• 「ログレコード」

• 「ロガー名前空間の階層」

ログレコード

Enterprise Server は、JSR 047 に記述された Java EE プラットフォームのロギング API を使用します。Enterprise Server のログメッセージはサーバーログ (通常は &DomainDir/logs/server.log) に記録されます。ログをローテーションするときに、Enterprise Server は server.log という名前で新しい空のファイルを作成し、古いファイルの名前を server.log_date に変更します。date はファイルがローテーションされた日付と時刻になります。

Enterprise Server のコンポーネントがログ出力を生成します。アプリケーションコンポーネントもログ出力を生成できます。

アプリケーションコンポーネントは、Apache Commons ロギングライブラリを使ってメッセージをロギングしてもかまいません。ただし、ログ設定を効率的に行いたい場合は、プラットフォーム標準の JSR 047 API を使用することをお勧めします。

ログレコードは次の統一形式に従います。

[#|yyyy-mm-ddThh:mm:ss.SSS-Z|Log Level|ProductName-Version|LoggerName|Key Value Pairs|Message|#]

次に例を示します。

[#|2006-10-21T13:25:53.852-0400|INFO|sun-appserver9.1|javax.enterprise.
system.core|_ThreadID=13;|CORE5004: Resource Deployed: 
[cr:jms/DurableConnectionFactory].|#]

この例について説明します。

• [# と #] はレコードの開始と終了をマーク付けします。

• 垂直バー (|) はレコードのフィールドを区切ります。

• 2006-10-21T13:25:53.852-0400 は日付と時刻を指定します。

• Log Level は INFO です。このレベルは次のいずれかの値を取ることができます。 SEVERE、WARNING、INFO、CONFIG、FINE、FINER、および FINEST 。

• ProductName-Version は sun-glassfish-comms-server1.0 です。

• LoggerName はログモジュールのソースを識別する階層ロガーの名前空間で、この場合は javax.enterprise.system.core です。

• Key Value Pairs はキー名と値で、通常は _ThreadID=14; のようなスレッド ID です。

• Message は、ログメッセージのテキストです。Enterprise Server のすべての SEVERE メッセージと WARNING メッセージ、および多くの INFO メッセージは、モジュールコードと数値から構成されるメッセージ ID (この場合は CORE5004) で始まります。

このログレコード形式は、将来のリリースでは変更または拡張される可能性があります。

ロガー名前空間の階層

Enterprise Server は各モジュールのロガーを提供します。次の表では、管理コンソールの「ログレベル」ページに表示されるとおりに、アルファベット順でモジュールの名前と各ロガーの名前空間を示します (「ログレベルの設定」を参照)。表内の最後の 3 つのモジュールは、「ログレベル」ページには表示されません。

表 17–1 Enterprise Server ロガー名前空間

モジュール名	名前空間
管理	javax.enterprise.system.tools.admin
クラスローダー	javax.enterprise.system.core.classloading
構成	javax.enterprise.system.core.config
コネクタ	javax.enterprise.resource.resourceadapter
CORBA	javax.enterprise.resource.corba
配備	javax.enterprise.system.tools.deployment
EJB コンテナ	javax.enterprise.system.container.ejb
グループ管理サービス (クラスタおよびエンタープライズプロファイルのみ)	javax.ee.enterprise.system.gms
JavaMail	javax.enterprise.resource.javamail
JAXR	javax.enterprise.resource.webservices.registry
JAXRPC	javax.enterprise.resource.webservices.rpc
JAXWS	javax.enterprise.resource.webservices.javaws
JBI	com.sun.jbi
JMS	javax.enterprise.resource.jms
JTA	javax.enterprise.resource.jta
JTS	javax.enterprise.system.core.transaction
MDB コンテナ	javax.enterprise.system.container.ejb.mdb
ネーミング	javax.enterprise.system.core.naming
持続性	oracle.toplink.essentials、javax.enterprise.resource.jdo、javax.enterprise.system.container.cmp
ノードエージェント (クラスタおよびエンタープライズプロファイルのみ)	javax.ee.enterprise.system.nodeagent
ルート	javax.enterprise
SAAJ	javax.enterprise.resource.webservices.saaj
セキュリティー	javax.enterprise.system.core.security
自己管理	javax.enterprise.system.core.selfmanagement
サーバー	javax.enterprise.system
同期 (クラスタおよびエンタープライズプロファイルのみ)	javax.ee.enterprise.system.tools.synchronization
Util	javax.enterprise.system.util
ベリファイア	javax.enterprise.system.tools.verifier
Web コンテナ	javax.enterprise.system.container.web