ロギング

Web Interface のサーバープログラムとフォルダ監視サービスは、ファイルとコンソールにログ情報を送ります。Apacheのlog4jライブラリを使用しているので、出力先とログの出力レベルを簡単に変更することができます。もしログ設定ファイルがオプションで指定されていなければ、デフォルトのロギングの振る舞いは、DEBUGレベルのメッセージを[install directory]/logs/[xds | folder-monitor].logとコンソールの両方に出力します。

log4jの設定はxmlファイルを使います。デフォルトではインストール先jarファイルと同じフォルダにあるlog4j2.xmlが読み込まれます。設定ファイルのディレクトリおよびファイル名を -D Java仮想マシンオプションを用いて、以下のように指定することができます。

  -Dlog4j.configurationFile=C:\test\log4j2.xml

次にxml形式の設定ファイルの例を示します。各項目は要素と属性をつかって構造的に表されます。詳細についてはlog4jのドキュメントを参照してください。

<?xml version="1.0" encoding="UTF-8"?>
<Configuration>
    
    <Properties>
        <Property name="format" value="%d [%t] %-5p %c{1} - %m%n"/> 
        <Property name="fileName" value="./logs/xds.log"/> 
        <Property name="archiveFileName" value="./logs/xds-%i.log"/> 
    </Properties>

    <Appenders>
        <!-- console log  -->
        <Console name="console" target="SYSTEM_OUT">
            <PatternLayout pattern="${format}"/>
        </Console>

        <!-- logfile and archive -->
        <RollingFile name="logfile" append="true" fileName="${fileName}"
                 filePattern="${archiveFileName}">
            <PatternLayout>
                <Pattern>${format}</Pattern>
            </PatternLayout>
            <Policies>
                <SizeBasedTriggeringPolicy size="3MB"/>
            </Policies>
            <DefaultRolloverStrategy max="8"/>
        </RollingFile>
    </Appenders>
    
    <Loggers>
        <Root level="DEBUG">
          <AppenderRef ref="console"/>
          <AppenderRef ref="logfile"/>
        </Root>
    </Loggers>
</Configuration>