5.5.5. 定期ログハンドラーの XML 設定例

手順5.5 定期ログハンドラーの設定

1. 定期ログハンドラーの ID 情報を追加します。

   name プロパティーは、このログハンドラーの一意の ID を設定します。
   autoflush を "true" に設定すると、ログメッセージは要求直後にハンドラーのターゲットに送信されます。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
   

   Copy to Clipboard Toggle word wrap

2. level プロパティーを設定します

   level プロパティーは、ルートロガーが記録するログメッセージの最大レベルを設定します。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
   

   Copy to Clipboard Toggle word wrap

3. encoding 出力を設定します。

   出力に使用する文字エンコーディングスキームを設定するには、encoding を使用します。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
   

   Copy to Clipboard Toggle word wrap

4. formatter を指定します。

   このログハンドラーで使用するログフォーマッターの一覧を表示するには、formatter を使用します。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
   

   Copy to Clipboard Toggle word wrap

5. file オブジェクトを設定します。

   file オブジェクトは、このログハンドラーの出力が書き込まれるファイルを表します。relative-to と path の 2 つの設定プロパティーが含まれます。
   relative-to プロパティーは、ログファイルが書き込まれるディレクトリーです。JBoss Enterprise Application Platform 6 のファイルパス変数をここで指定できます。jboss.server.log.dir 変数はサーバーの log/ ディレクトリーを指します。
   path プロパティーは、ログメッセージが書き込まれるファイルの名前です。これは、完全パスを決定するために relative-to プロパティーの値に追加される相対パス名です。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
      <file relative-to="jboss.server.log.dir" path="server.log"/>
   

   Copy to Clipboard Toggle word wrap

6. suffix 値を設定します

   suffix は、ローテーションされたログのファイル名に追加され、ローテーションの周期を決定するために使用されます。suffix の形式では、ドット (.) の後に java.text.SimpleDateFormat クラスで解析できる日付文字列が指定されます。ログは suffix で定義された最小時間単位に基づいてローテーションされます。たとえば、yyyy-MM-dd の場合は、ログが日次でローテーションされます。http://docs.oracle.com/javase/6/docs/api/index.html?java/text/SimpleDateFormat.htmlを参照してください。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
      <file relative-to="jboss.server.log.dir" path="server.log"/>
      <suffix value=".yyyy-MM-dd"/>
   

   Copy to Clipboard Toggle word wrap

7. append プロパティーを設定します。

   append プロパティーを "true" に設定した場合、このハンドラーが書き込んだすべてのメッセージが既存のファイルに追加されます。"false" に設定した場合、アプリケーションサーバーが起動するたびに新規ファイルが作成されます。append への変更を反映させるには、サーバーの再起動が必要です。

   <periodic-rotating-file-handler name="FILE" autoflush="true">
      <level name="INFO"/>
      <encoding value="UTF-8"/>
      <formatter>
         <pattern-formatter pattern="%d{HH:mm:ss,SSS} %-5p [%c] (%t) %s%E%n"/>
      </formatter>
      <file relative-to="jboss.server.log.dir" path="server.log"/>
      <suffix value=".yyyy-MM-dd"/>
      <append value="true"/>
   </periodic-rotating-file-handler>
   

   Copy to Clipboard Toggle word wrap