ヘッダーをスキップ

Oracle Containers for J2EE構成および管理ガイド
10g（10.1.3.1.0）
B31849-01
目次
目次		 索引
索引

戻る 次へ

11 OC4Jでのロギング

この章では、OC4Jで使用できるシステムおよびアプリケーションのロギング機能の使用方法について説明します。この章の内容は次のとおりです。

OC4Jにより生成されるログ・ファイルの概要

各OC4Jプロセスでは、トラブルシューティングを支援するために多くのログ・ファイルが生成されます。1つのOC4Jインスタンスに対して複数のプロセスが稼働している場合、複数セットのログ・ファイルが生成されます。

OC4Jでは、次に示す2種類のログ・ファイルが生成されます。

ログ・ファイルは、データの記録対象となるコンポーネントまたはアプリケーションに応じて異なる場所に生成されます。各コンポーネントまたはアプリケーションのロギング構成は、コンポーネント固有のXML構成ファイルに定義されます。

表11-1に、生成される各種ログ・ファイルの名前および場所とともに、各コンポーネントのロギング構成が含まれるXML構成ファイルを示します。特に明記されていないかぎり、示されるパスはすべて、スタンドアロンOC4Jの場合はORACLE_HOME/j2ee/home内、OPMN管理のOC4Jインスタンスの場合はORACLE_HOME/j2ee/instance内です。

表11-1    OC4Jで生成されるログ・ファイルのリスト 
コンポーネント  構成ファイル  デフォルトのログ・ファイル名および場所 

Javaロギングを使用するOC4Jコンポーネント 

このODL形式のログ・ファイルの構成方法は、「OC4Jロギングの構成」を参照してください。 

スタンドアロンOC4J: 

/log/oc4j/log.xml

OPMN管理OC4J: 

/log/instance_default_group_1/oc4j/log.xml
 

Application Server Controlコンソール 

 
/application-deployments/ascontrol/
orion-application.xml
 

スタンドアロンOC4J: 

/log/ascontrol-application.log

OPMN管理OC4J: 

/log/instance_default_group_1/ascontrol-application.log
 

OC4Jにデプロイされたアプリケーション 

 
/application-deployments/app_name/
orion-application.xml
 

スタンドアロンOC4J: 

/application-deployments/app_name/application.log

OPMN管理OC4J: 

/application-deployments/app_name/instance_default_group_1/application.log
 

グローバル（default）アプリケーション 

 
/config/application.xml
 

スタンドアロンOC4J: 

/log/global-application.log

OPMN管理OC4J: 

/log/instance_default_group_1/global-application.log
 

デフォルトWebサイトのアクセス・ロギング 

 
/config/default-web-site.xml
 

スタンドアロンOC4J: 

/log/default-web-access.log

OPMN管理OC4J: 

/log/instance_default_group_1/default-web-access.log
 

OC4Jサーバー 

 
/config/server.xml
 

スタンドアロンOC4J: 

/log/server.log

OPMN管理OC4J: 

/log/instance_default_group_1/server.log
 

JMS 

 
/config/jms.xml
 

スタンドアロンOC4J: 

/log/jms.log

OPMN管理OC4J: 

/log/instance_default_group_1/jms.log
 

RMI 

 
/config/rmi.xml
 

スタンドアロンOC4J: 

/log/rmi.log

OPMN管理OC4J: 

/log/instance_default_group_1/rmi.log
 

OPMN 

ORACLE_HOME/opmn/conf/opmn.xml 

ORACLE_HOME/opmn/logs 

プレーン・テキスト・ファイル・ロギングの使用方法

プレーン・テキスト・ロギングは、OC4Jで使用されるデフォルトの形式です。

この方式は、XMLファイルに合せてメッセージを振り分けます。しかし、同じサイズの複数のログ・ファイルに書き込むのではなく、そのコンポーネントに対するすべてのメッセージを単一のログ・ファイルに書き込みます。次の各項では、テキスト・ロギングの使用方法について説明します。

テキスト・ファイル・ロギングの有効化または無効化

テキスト・ロギングは、表11-1に示したXML構成ファイル（default-web-site.xmlファイルを除く）の要素により、有効または無効になります。（Webサイトのアクセス・ロギングの構成方法は、「Webサイトのアクセス・ロギングの構成」を参照してください。）

ロギングは、各コンポーネントのXML構成ファイルの<log>要素の<file>サブ要素によって有効になります。この要素には、単一のpath属性が含まれ、生成されるログ・ファイルの名前と、必要に応じて場所を指定します。

<log>
  <file path="application.log" />
</log>

コンポーネントのテキスト・ロギングを無効にするには、対応する構成ファイルの<file>要素を削除するか、コメント・アウトします。この行を削除しないでODLを有効にすると、両方のロギング・オプションが有効になります。

たとえば、アプリケーションのテキスト・ロギングを無効にするには、そのアプリケーションのorion-application.xmlファイルで次の要素をコメント・アウトします。

<!-- 
<log>
  <file path="application.log" />
</log> 
-->

ODLとテキスト・ロギングの両方を同時に有効にできますが、ディスク領域を節約するには、これらのオプションのいずれかを無効にする必要があります。

テキスト・ログ・ファイルの管理

テキスト・ロギングにはサイズ制限やログ循環機能がないため、ログ・ファイルの監視は重要です。チェックしないままにしておくと、ログ・ファイルのサイズは増大し続け、ディスク超過が発生する可能性があります。

これらのファイルを管理する唯一の方法は、OC4Jを停止し、ファイルを削除した後、OC4Jを再起動してログ・ファイルを新しく始めることです。

テキスト・ログ・ファイルの表示

すべてのテキスト・ログ・ファイルは、表11-1「OC4Jで生成されるログ・ファイルのリスト」に示した場所にデフォルトで生成されます。テキスト・ログ・ファイルは、log拡張子によって識別できます。

OC4Jコンポーネントに対して生成されるテキスト・ログ・ファイルは、次のようにApplication Server Controlコンソールを使用して表示できます。

  1. Application Server Controlコンソールのページの一番下にある「ログ」リンクをクリックします。

  2. 「OC4J」を開きます。

  3. 「<instanceName>」を開きます。デフォルトのインスタンス名はhomeです。

デプロイ済J2EEアプリケーションのテキスト・ログ・ファイルは、Application Server Controlコンソールを使用して表示することはできません。

Oracle Diagnostic Logging（ODL）の使用方法

Oracle Diagnostic Loggingフレームワーク（ODL）には、標準Javaフレームワークを補完して、ログ・データとOracleログ分析ツールを自動的に統合するプラグイン・コンポーネントが用意されています。

ODLフレームワークでは、ログ・ファイルはXML文書形式で作成され、他のOracle Application Serverやカスタム開発されたコンポーネント（Application Server Controlコンソールなど）によるログの分析および再利用を可能にします。ODLのもう1つの主な利点は、テキストベースのロギングとは異なり、ログ・ファイルの循環をサポートしていることです。

ODLの有効化または無効化

ODLは、<odl>要素を表11-1に示したXMLファイルの<log>要素内に追加すると有効になります。

注意

  • ODLは、アプリケーションがデプロイされる際に、デプロイ・プラン・エディタを使用してlogプロパティのodlsに値を設定すると、アプリケーションに対して有効にできます。

    デプロイ・プラン・エディタを使用したアプリケーションの構成方法は、『Oracle Containers for J2EEデプロイメント・ガイド』を参照してください。

  • Webサイトに対するODLは、異なる構成を使用します。Webサイトのアクセス・ロギングの構成方法は、「Webサイトのアクセス・ロギングの構成」を参照してください。

  • ODLとテキスト・ファイル・ロギングの両方を同時に有効にできます。しかし、ディスク領域を節約するには、これらのオプションのいずれかを無効にする必要があります。

 

<odl>要素には次の属性があります。すべて必須です。

たとえば、petstoreアプリケーションのorion-application.xmlファイルの次のエントリは、このアプリケーションに対してlog.xmlファイルを生成します。また、ログ・ファイルの最大値を1,000KB、ディレクトリの最大値を10,000KBに設定します。

<log>
  <odl path="../log/petstore/" max-file-size="1000" max-directory-size="10000" />
</log>

この構成を使用して、petstoreログ・ファイルは、使用しているOC4Jインストールに応じて、次の場所に生成されます。

ODLログ・ファイルの管理

ODLフレームワークでは、ログ・ファイルの循環などログ・ファイルの管理をサポートしています。ログ・ファイルの最大サイズおよびログ・ディレクトリの最大サイズも定義できます。また、OLDを使用すると次のような利点があります。

ODLログは、現行のログ・ファイルlog.xml、および古いメッセージが含まれるゼロ以上のOLDアーカイブ（セグメント・ファイル）を含む一連のログ・ファイルです。ODLを有効にすると、新しいメッセージはそれぞれ、log.xmlの最後に追加されます。このログ・ファイルは循環ポイントに達すると名前が変更され、新しいlog.xmlファイルが作成されます。

現行のログ・ファイルが循環ポイントに達するとセグメント・ファイルが作成されます。この循環ポイントは最大ODLセグメント・サイズとして、また、一部のOC4Jログでは循環時間および循環頻度として指定されています。log.xmlファイルはlogn.xmlという名前に変更されます。ここでnは1から始まる整数です。新しいlog.xmlファイルは、コンポーネントにより新しい診断メッセージが生成されると作成されます。

最後のログ・ファイルがいっぱいになると、次の手順で処理されます。

  1. ディレクトリの領域を空けるため、最も古いログ・ファイルが消去されます。

  2. log.xmlファイルが最新のlogn.xmlファイルに書き込まれます。nは、最新のログ・ファイルを1だけ増やした値です。

サイズベースのログ循環

ODLログやコンポーネントのサイズを制限するには、ログ・ディレクトリの最大サイズを指定する構成オプションを使用します。ディレクトリ内の全ファイルの合計サイズが最大サイズに達すると、合計サイズを指定された制限内に保つために最も古いアーカイブが削除されます。

注意

最新のセグメント・ファイルは削除されません。 

たとえば、log9872という名前のセグメント・ファイルで開始し、最大ディレクトリ・サイズに達したとき、ログ・ファイル・ディレクトリに次のファイルが存在するとします。

File                        Size

log.xml                     10002
log9872.xml                 15000
log9873.xml                 15000
log9874.xml                 15000
log9875.xml                 15000
log9876.xml                 15000

この場合、log.xmlがいっぱいになるとlog9872.xmlが削除されて、log.xmlの内容が新しいファイルlog9877.xmlに移動されます。その後、新しい診断メッセージが新しいlog.xmlファイルに書き込まれます。

たとえば、petstoreと言う名前のOC4Jアプリケーションに最大のODLセグメント・サイズおよび最大ディレクトリ・サイズを指定するには、ファイルORACLE_HOME/j2ee/instance_name/application-deployments/petstore/orion-application.xmlに次のエントリを追加します。

<log>
<odl path="../log/petstore/" max-file-size="1000" max-directory-size="10000" />
</log>

j2ee-logging.xmlファイルに構成されているOC4Jコンポーネントの場合は、最大セグメント・サイズおよびディレクトリ・サイズに加えて、循環時間と循環頻度も指定できます。

時間ベースのログ循環

時間ベースのログ循環では、<logging-configuration>ルート要素の<log-handlers>要素の<log_handler>サブ要素に次に示すプロパティを指定できます。

これらのプロパティは次のファイルに指定します。

ORACLE_HOME/j2ee/instance_name/config/j2ee-logging.xml

たとえば、毎日ローカル時間の午前4時、またはサイズが2000000バイトに達した時にログ・ファイルを循環すると指定するには、次のようにします。

<log_handler name="h1" class="oracle.core.ojdl.logging.ODLHandlerFactory">
     <property name="path" value="log"/>
     <property name="baseRotationTime" value="04:00"/>
     <property name="rotationFrequency" value="daily"/>
     <property name="maxFileSize" value=" 2000000"/> 
</log_handler>

ODLログ・ファイルの表示

ODL形式のログ・ファイルは、WebベースのApplication Server Controlコンソールで「ログ」リンクをクリックすると表示でき、管理者は、一元管理された場所からOC4J内で稼働しているすべてのコンポーネントおよびアプリケーションによって生成されたロギング出力を集計および表示できます。

ODLログ・ファイルは、「ログ・ファイル」ページでは.xml拡張子で識別されます。

  1. Application Server Controlコンソールのページの一番下にある「ログ」リンクをクリックします。

  2. 「OC4J」を開きます。

  3. 「<instanceName>」を開きます。スタンドアロンOC4JとOASのいずれでも、デフォルト・インスタンス名はhomeです。

OC4Jロギングの構成

OC4Jの各種コンポーネントでは、OC4Jログ・ファイルに書き込むJavaログ出力を利用します。OC4Jログ・ファイルは、Oracle Diagnostic Loggingフレームワークを使用してXML形式で生成され、Application Server Controlコンソールを使用して表示できます。

この項の内容は次のとおりです。

OC4Jコンポーネント・ログ出力の使用方法と構成

OC4Jには、OC4Jログ・ファイル（log.xml）に書き込む多くのコンポーネント・ログ出力が用意されています。使用可能なコンポーネント・ログ出力は、Application Server Controlコンソールの「ログ出力の構成」ページを使用して表示および構成できます。

Javaのログ・レベルは、個々のコンポーネント・ログ出力ごとに設定できます。NULLに設定すると、ログ出力は、親に設定されたログ・レベルを継承します。

したがって、すべてのログ出力のデフォルト・レベルは、oracleログ出力から継承されるデフォルト値であるINFOです。この値は、Javaログ・レベルNOTIFICATIONにマップされます。このデフォルト値の変更方法は、「oracleログ出力の構成」を参照してください。

「ログ出力の構成」ページからログ出力に設定されたログ・レベルは保存されず、OC4Jランタイムにのみ適用されます。OC4Jが再起動されると、ログ・レベルは親ログ出力から継承されるデフォルト設定に戻ります。

次の表11-2に、Application Server Controlコンソールから設定できるログ・レベルと、それぞれのマップ先となるODLメッセージ・タイプ:ログ・レベルを示します。

表11-2    OC4Jログ出力のログ・レベル 
Javaログ・レベル  ODLメッセージ・タイプ:ログ・レベル  ODLの説明  
NULL
 

 

ログ出力は、親に設定されたログ・レベルを継承します。 

 
SEVERE
 		 
ERROR:1
 

システム管理者が注意する必要があるシステム・エラーを記録します。 

 
WARNING
 		 
WARNING:1
 

エラーが発生する前に確認して処理する必要があるとして検出されたアクションまたは条件を記録します。 

 
INFO
 		 
NOTIFICATION:1
 

標準のアクションまたはイベントを記録します。ユーザー操作（「ログイン完了」など）や自動操作（ログイン・ファイルの循環など）が該当します。 

 
CONFIG
 		 
NOTIFICATION:16
 

構成関連のメッセージまたは問題を記録します。 

 
FINE
 		 
TRACE:1
 

デバッグやパフォーマンスの監視に使用されるトレースまたはデバッグのメッセージを記録します。通常、詳細なイベント・データが含まれます。  

 
FINER
 		 
TRACE:16
 

非常に詳細なトレースまたはデバッグのメッセージを記録します。 

 
FINEST
 		 
TRACE:32
 

きわめて詳細なトレースまたはデバッグのメッセージを記録します。 

OC4Jコンポーネント・ログ出力をApplication Server Controlコンソールから構成するには、次のようにします。

  1. 「管理」リンクをクリックします。

  2. 「ログ出力の構成」をクリックします。

  3. ログ・レベルを上の表11-2の左列に示された値に設定します。

  4. 「適用」をクリックして、変更をOC4Jランタイムに適用します。

OC4Jログ・ファイルの表示

OC4Jログ・ファイルは、Application Server Controlコンソールを使用して表示できます。ファイルを表示するには、次のようにします。

  1. Application Server Controlコンソールのページの一番下にある「ログ」リンクをクリックします。

  2. 「OC4J」を開きます。

  3. 「<instanceName>」を開きます。スタンドアロンOC4JとOASのいずれでも、デフォルト・インスタンス名はhomeです。

  4. 診断メッセージ・ログを開きます。

すべてのODLログ・ファイルと同様に、新しいメッセージはそれぞれ、log.xmlという最新のログ・ファイルに格納されます。最大サイズに達すると、ログはlogn.xmlというアーカイブ・ログ・ファイルにコピーされます。nは、1から始まる整数です。

oracleログ出力の構成

oracleログ出力の構成は、j2ee-logging.xmlに定義されます。このファイルは、ORACLE_HOME/j2ee/instance/configディレクトリにインストールされています。

OC4J 10g（10.1.3.1.0）では、次のように、Application Server Controlコンソールを使用してログ出力のログ・レベルを設定できます。

  1. OC4Jホームページで「管理」をクリックします。

  2. 管理タスクから、「ログ出力の構成」を選択して「ログ出力の構成」ページを表示します。

  3. 「すべてを開く」をクリックして、現在OC4Jインスタンスにロードされているログ出力の全リストを表示します。

  4. ページに表示されている任意のログ出力のログ・レベルを選択します。

また、j2ee-logging.xml構成ファイルは手動で編集することもできます。このファイルの変更後には、OC4Jを再起動してください。

構成ファイルには、<logging-configuration>ルート要素内に次の2つの要素があります。

次の例では、ODLメッセージ・タイプ:ログ・レベルとしてTRACE:32を指定し、デフォルトのログ・レベルをFINESTに設定しています。

<logging_configuration>
  <log_handlers>
    <log_handler name='oc4j-handler'
        class='oracle.core.ojdl.logging.ODLHandlerFactory'>
      <property name='path' value='%ORACLE_HOME%/j2ee/%OPMN_PROC_TYPE%/log/
           %OPMN_PROC_TYPE%_%OPMN_PROC_SET%_%OPMN_PROC_INDEX%/oc4j'/>
      <property name='maxFileSize' value='10485760'/>
      <property name='maxLogSize' value='104857600'/>
    </log_handler>
  </log_handlers>
  <loggers>
    <logger name='oracle' level='TRACE:32' useParentHandlers='false'>
      <handler name='oc4j-handler'/>
    </logger>
  </loggers>
</logging_configuration>
戻る 次へ
Oracle
Copyright © 2006 Oracle Corporation.
All Rights Reserved.
目次
目次		 索引
索引