B.5.3 ログの定義(log)

マッシュアップフレームワークのログの出力情報は、log要素で定義します。

記述形式

<muf_property>
  ...
  <muf_admin>
    ...
     <log>
       <accesslog valid="出力の有無">
         <output path="出力先パス" prefix="ファイル名" extension="ファイル拡張子" />
         <rotation daily="日付分割の有無" />
         <rotation_size maxsize="分割サイズ" backup="分割数" />
       </accesslog>
       <systemlog level="ログレベル">
         <output path="出力先パス" prefix="ファイル名" extension="ファイル拡張子" />
         <rotation daily="日付分割の有無" />
         <rotation_size maxsize="分割サイズ" backup="分割数" />
       </systemlog>
     </log>
    ...
  </muf_admin>
  
</muf_property>

要素の内容

要素名	説明	省略	複数指定
accesslog	アクセスログの出力情報を指定します。 valid属性にログの出力の有無を指定します。 true 出力する false 出力しない	×	×
accesslog/output	アクセスログの出力先を指定します。 path属性に出力先パスを、prefix属性にファイル名を、extension属性にファイル拡張子を指定します。出力先パスは、ディレクトリ分割記号に「/」を使用して、絶対パス形式で記述します。出力先パスが「/」で終了していない場合は、「/」が自動的に付加されます。なお、出力先パスに「[contextroot]」を指定すると、コンテキストルートが参照されます。ファイル名とファイル拡張子は、シングルバイト文字列で記述します。	×	×
accesslog/rotation	アクセスログファイルの日付分割の有無をdaily属性に指定します。 true サイズ分割指定に加えて日付分割を行う false 日付分割を行わない	×	×
accesslog/rotation_size	maxsize属性にアクセスログファイルの分割サイズ(Mバイト単位)を、backup属性にアクセスログファイルの最大分割数を指定します。	×	×
systemlog	システムログの出力情報を指定します。 level属性にログの出力レベルを以下の数値で指定します。 5 ERRORレベルのログだけを出力 10 ERRORおよびWARNレベルのログを出力 20 ERROR、WARN、およびINFOレベルのログを出力	×	×
systemlog/output	システムログの出力先を指定します。 path属性に出力先パスを、prefix属性にファイル名を、extension属性にファイル拡張子を指定します。出力先パスは、ディレクトリ分割記号に「/」を使用して、絶対パス形式で記述します。出力先パスが「/」で終了していない場合は、「/」が自動的に付加されます。なお、出力先パスに「[contextroot]」を指定すると、コンテキストルートが参照されます。ファイル名とファイル拡張子は、シングルバイト文字列で記述します。	×	×
systemlog/rotation	システムログファイルの日付分割の有無をdaily属性に指定します。 true サイズ分割指定に加えて日付分割を行う false 日付分割を行わない	×	×
systemlog/rotation_size	maxsize属性にシステムログファイルの分割サイズ(Mバイト単位)を、backup属性にシステムログファイルの最大分割数を指定します。	×	×

×: 不可能

記述例

<muf_property>
  ...
  <muf_admin>
    ...
     <log>
       <accesslog valid="true">
         <output path="[contextroot]/WEB-INF/log/" prefix="muacclog" extension="txt" />
         <rotation daily="true" />
         <rotation_size maxsize="10" backup="10" />
       </accesslog>
       <systemlog level="5">
         <output path="[contextroot]/WEB-INF/log/" prefix="musyslog" extension="txt" />
         <rotation  daily="false" />
         <rotation_size maxsize="10" backup="10" />
       </systemlog>
     </log>
    ...
  </muf_admin>
  
</muf_property>

ログファイル名

以下に、出力されるログファイル名の書式を示します。

[ログファイル名][日付][連番][拡張子]

以下に、各項目について説明します。

項目	説明
ログファイル名	output要素のprefix属性に指定したファイル名が設定されます。
日付	rotation要素のdaily属性にtrueを指定した場合に、「YYYYMMDD」の形式で設定されます。 rotation要素のdaily属性にfalseを指定した場合は省略されます。
連番	連番は0から始まり、rotation_size要素のmaxsize属性に指定した分割サイズに従って、backup属性に指定した最大分割数まで設定されます。
拡張子	output要素のextension属性に指定したファイル拡張子が設定されます。