第 17 章 ロギングの設定

この章では、ロギングの設定方法とサーバーログの表示方法について簡単に説明します。この章の内容は次のとおりです。

• 「ロギングについて」

• 「ロギングの設定」

ロギングについて

• 「ログレコード」

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

ログレコード

Application Server は、JSR 047 に指定されている「Java EE platform Logging API」を使用します。Application Server のログメッセージはサーバーログ内に記録されます。このサーバーログの場所は通常、domain-dir/logs/server.log です。ログをローテンションするときに、Application Server は server.log という名前で新しい空のファイルを作成し、古いファイルの名前を server.log_date に変更します。date はファイルがローテーションされた日付と時刻になります。

domain-dir/logs ディレクトリには、サーバーログのほかに別の 2 種類のログも格納されます。access サブディレクトリには HTTP サービスアクセスログ、tx サブディレクトリにはトランザクションサービスログがあります。これらのログについては、「トランザクションの設定」を参照してください。

Application 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-appserver9.1です。

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

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

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

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

ロガー名前空間の階層

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

表 17–1 Application 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 org.apache.catalina org.apache.coyote org.apache.jasper

ロギングの設定

ここでは、次の内容について説明します。

• 「ログの一般設定」

• 「ログレベルの設定」

• 「サーバーログの表示」

ログの一般設定

管理コンソールを使用してログの一般設定を設定するには、次の手順に従います。

• 開発者プロファイルの場合は、「Application Server」->「ログ」->「一般」の順に選択します。

• クラスタプおよびエンタープライズプロファイルの場合は、「設定」->「設定」->「ログ設定」->「一般」の順に選択します。

「一般」ページで適切な値を入力し、必要に応じてログをカスタマイズします。Application Server を停止して再起動します。

各設定パラメータの設定の詳細については、管理コンソールで「ヘルプ」をクリックしてください。

これらのログ設定を asadmin で設定するには、get および set コマンドを使用します。

ログレベルの設定

管理コンソールを使用してログレベルを設定するには、次の手順に従います。

• 開発者プロファイルの場合は、「Application Server」->「ログ」->「ログレベル」の順に選択します。

• クラスタおよびエンタープライズプロファイルの場合は、「設定」->「設定」->「ログ」->「ログ設定」->「ログレベル」の順に選択します。

このページで、一覧表示されたモジュールのログレベルを設定します。アプリケーションロガーのログレベルを設定するには、「追加プロパティー」領域を使用します。モジュールロガーの一覧については、「ロガー名前空間の階層」を参照してください。

各設定パラメータの設定の詳細については、管理コンソールで「ヘルプ」をクリックしてください。

これらのログ設定を asadmin で設定するには、get および set コマンドを使用します。

サーバーログの表示

ログファイルを表示するには、次の手順に従います。

• 開発者プロファイルの場合は、「Application Server」->「ログ」->「ログファイルを表示」の順に選択します。

• クラスタおよびエンタープライズプロファイルの場合は、「設定」->「設定」->「ロガーの設定」->「一般」の順に選択し、「ログファイルを表示」をクリックします。

設定内容に基づいたログ結果を表示するには、「検索基準」領域に示されているオプションを使用します。

• インスタンス名: ドロップダウンリストからインスタンス名を選択して、そのサーバーインスタンスのログを表示します。デフォルトは現在のサーバーインスタンスです。

• ログファイル: ドロップダウンリストからログファイル名を選択して、そのログのコンテンツを表示します。デフォルトは server.log です。

• タイムスタンプ: 最新のメッセージを表示するには、「最新」 (デフォルト) を選択します。特定期間内のメッセージだけを表示するには、「特定範囲」を選択して、表示される「開始」と「終了」フィールドに日付と時刻を入力します。時刻の値の構文は次の形式を必ず使用してください (SSS はミリ秒)。

  hh:mm:ss.SSS

  次に例を示します。

  17:10:00.000

  「開始」フィールドの値が「終了」フィールドの値よりも遅い場合は、エラーメッセージが表示されます。

• ログレベル: ログレベルでメッセージをフィルタリングするには、ドロップダウンリストからログレベルを選択します。デフォルトでは、サーバーログにある選択したログレベルおよびさらに重大なレベルのすべてのメッセージが表示に含まれます。選択したレベルのメッセージだけを表示するには、「より重度の高いメッセージをこれ以上含めない」というラベルの付いたチェックボックスを選択します。

  表示したいメッセージを確実にサーバーログに表示するには、最初に「ログレベル」ページで適切なログレベルを設定してください。「ログレベルの設定」を参照してください。

  ログレベルに基づくログメッセージのフィルタリングを選択する場合、指定したフィルタリング基準と一致するメッセージだけが表示されます。しかし、このフィルタリングは、どのメッセージがサーバーログに記録されるかには影響しません。

  最新の 40 エントリが「ログ設定」と「ログレベル」ページで指定した設定で表示されます。

  最新のメッセージが最後に表示されるようにメッセージを並べ替えるには、タイムスタンプヘッダーのとなりの矢印をクリックします。

  形式設定済みのメッセージを表示するには、次の印が付いたリンクをクリックします。

  (詳細)

  「ログエントリの詳細」というウィンドウが現れて、形式設定済みメッセージを表示します。

  エントリのリストの末尾で、ボタンをクリックしてログファイルの古いエントリまたは新しいエントリを表示します。

  「検索基準」領域で「詳細検索」をクリックして、ログビューアの詳細設定を行います。「詳細オプション」フィールドは次のように使用します。

• ロガー — モジュール別にフィルタリングするには、ドロップダウンリストから 1 つ以上の名前空間を選択します。shift-click または control-click を使い、複数の名前空間を選択します。

  上位レベルの名前空間を 1 つ選ぶと、その下のすべての名前空間が選択されます。たとえば、javax.enterprise.system を選択すると、その名前空間の下にあるすべてのモジュールのロガーも選択されます。javax.enterprise.system.core、javax.enterprise.system.tools.admin などです。

• カスタムロガー — 特定のアプリケーションに固有のロガーのメッセージを表示するには、テキストフィールドで 1 行に 1 つずつロガー名を入力します。アプリケーションに複数のモジュールがある場合は、そのいずれかまたはすべてを表示できます。たとえば、使用しているアプリケーションに次の名前のロガーがあるとします。

  com.mycompany.myapp.module1 com.mycompany.myapp.module2 com.mycompany.myapp.module3

  アプリケーション内のすべてのモジュールのメッセージを表示するには、com.mycompany.myapp と入力します。module2 のメッセージだけを表示するには、com.mycompany.myapp.module2 と入力します。

  1 つ以上のカスタムロガーを指定した場合、Application Server モジュールのメッセージは、「ロガー」領域で明示的に指定されるときだけ表示されます。

• 名前と値のペア — 特定のスレッドの出力を表示するには、テキストフィールドにスレッドのキー名と値を入力します。キー名は _ThreadID です。次に例を示します。

  _ThreadID=13

  com.mycompany.myapp.module2 がいくつかのスレッドで実行されるとします。1 つのスレッドの出力だけを表示するようにログビューアを修正するには、「カスタムロガー」フィールドでモジュールのロガーを指定してからこのフィールドにスレッド ID を指定します。

• 表示 — 一度に 40 メッセージ (デフォルト) 以上を表示するには、ドロップダウンリストからほかの可能な値 (100、250、または 1000) を選択します。

  スタックトレースを表示するには、「過度に長いメッセージを制限」チェックボックスのチェックマークを外します。デフォルトでは、スタックトレースはビューアに表示されませんが、メッセージの 「(詳細)」リンクをクリックすると表示できます。

  「基本検索」をクリックして、「詳細オプション」領域を非表示にします。