biz-Streamマニュアル Webサービスサーバ ガイド 第3章 ログ設定 3.4 ログレベルの変更方法

3.4 ログレベルの変更方法

logback.xml の初期設定では、bspdf.log、bsxml.log、bs.log、other.log、axis2.log、jackrabbit.log は WARNレベル以上のログのみ出力するように設定されていますが、 動作確認や問題発生時の原因調査のためにログレベルを変更することが可能です。

変更の手順は以下のとおりです。

  1. logback.xml をテキストエディタで開き、各ログ設定の <logger>タグのlevel属性の値を「WARN」から「INFO」または「DEBUG」へ手動で変更してください。
  2. 設定変更を反映させるためには、アプリケーションを再起動して logback.xml を再読み込みする必要があります。
  3. 動作検証完了後は設定を元に戻してください。大量のログ出力はパフォーマンス低下の原因となりますのでご注意ください。
logback.xml
<?xml version="1.0" encoding="UTF-8"?>
<configuration debug="true">
	<!-- Log output destination -->
	<property name='log.dir' value="../logs" />

	<!--
		SOAP Log definitions
	-->
	<appender name="SOAP_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/soap.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/soap.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%X{RequestTime} %d{yyyy-MM-dd HH:mm:ss.SSS} %X{HostName} %X{IpAddress} %X{Service} %X{Operation} %X{User} %X{UserDef}%n</Pattern>
			<!--
			<Pattern>%X{RequestTime} %d{yyyy-MM-dd HH:mm:ss.SSS} %X{HostName} %X{IpAddress} %X{Service} %X{Operation} %X{User} %X{UserDef}%n%X{RequestEnvelope}%n%X{ResponseEnvelope}%n</Pattern>
			-->
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<logger name="com.brainsellers.webservices.logging.LogHandler" additivity="false" level="INFO">
		<appender-ref ref="SOAP_FILE" />
	</logger>

	<!--
		Axis2 Log definitions
	-->
	<appender name="AXIS2_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/axis2.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/axis2.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %level %logger - %msg%n%ex{full}</Pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<logger name="org.apache.axis2" additivity="false" level="WARN">
		<appender-ref ref="AXIS2_FILE" />
	</logger>

	<!--
		WebDAV Log definitions
	-->
	<appender name="WEBDAV_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/webdav.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/webdav.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %X{HostName}/%X{IpAddress} %X{User} %X{Method} %X{URI}%n</Pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<logger name="org.apache.jackrabbit.j2ee.SimpleWebdavWithLoggingServlet" additivity="false" level="INFO">
		<appender-ref ref="WEBDAV_FILE" />
	</logger>

	<!--
		Jackrabbit Log definitions
	-->
	<appender name="JACKRABBIT_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/jackrabbit.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/jackrabbit.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %level %logger - %msg%n%ex{full}</Pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<!--
		Suppressing the output of the SearchIndex WARN log when starting Web Service Server
	-->
	<logger name="org.apache.jackrabbit.core.query.lucene.SearchIndex" additivity="false" level="ERROR">
		<appender-ref ref="JACKRABBIT_FILE" />
	</logger>
	<logger name="org.apache.jackrabbit" additivity="false" level="WARN">
		<appender-ref ref="JACKRABBIT_FILE" />
	</logger>

	<!--
		PDF-Library Log definitions
	-->
	<appender name="PDFLIB_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/bspdf.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/bspdf.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %level %logger - %msg%n%ex{full}</Pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<logger name="com.brainsellers.pdf" additivity="false" level="WARN">
		<appender-ref ref="PDFLIB_FILE" />
	</logger>

	<!--
		XML-Library Log definitions
	-->
	<appender name="XMLLIB_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/bsxml.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/bsxml.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %level %logger - %msg%n%ex{full}</Pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<logger name="com.brainsellers.xml" additivity="false" level="WARN">
		<appender-ref ref="XMLLIB_FILE" />
	</logger>

	<!--
		biz-Stream related libraries Log definitions
	-->
	<appender name="BIZLIB_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/bs.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/bs.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %level %logger - %msg%n%ex{full}</Pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<logger name="com.brainsellers" additivity="false" level="WARN">
		<appender-ref ref="BIZLIB_FILE" />
	</logger>

	<!--
		Other Log definitions
	-->
	<appender name="ROOT" class="ch.qos.logback.core.rolling.RollingFileAppender">
		<file>${log.dir}/other.log</file>
		<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
			<FileNamePattern>${log.dir}/other.%d{yyyy-MM-dd}.log</FileNamePattern>
		</rollingPolicy>
		<encoder>
			<Pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %level %logger - %msg%n%ex{full}</Pattern>
			<charset>UTF-8</charset>
		</encoder>
	</appender>
	<!--
		For Bug 66337 - In-Memory HSSF warns about missing SummaryInformation
		https://bz.apache.org/bugzilla/show_bug.cgi?id=66337
	-->
	<logger name="org.apache.poi.POIDocument" additivity="false" level="ERROR">
		<appender-ref ref="ROOT" />
	</logger>
	<!--
		Suppressing the output of the PDFBox & FontBox WARN log when a PDF file is stored in the repository
	-->
	<logger name="org.apache.pdfbox" additivity="false" level="ERROR">
		<appender-ref ref="ROOT" />
	</logger>
	<logger name="org.apache.fontbox" additivity="false" level="ERROR">
		<appender-ref ref="ROOT" />
	</logger>
	<root level="WARN">
		<appender-ref ref="ROOT" />
	</root>
</configuration>

上記のうち、以下の箇所についてはログレベルを ERROR から変更しないでください。
  • jackrabbit.log の設定
    	<!--
    		Suppressing the output of the SearchIndex WARN log when starting Web Service Server
    	-->
    	<logger name="org.apache.jackrabbit.core.query.lucene.SearchIndex" additivity="false" level="ERROR">
    		<appender-ref ref="JACKRABBIT_FILE" />
    	</logger>
    
  • other.log の設定
    	<!--
    		For Bug 66337 - In-Memory HSSF warns about missing SummaryInformation
    		https://bz.apache.org/bugzilla/show_bug.cgi?id=66337
    	-->
    	<logger name="org.apache.poi.POIDocument" additivity="false" level="ERROR">
    		<appender-ref ref="ROOT" />
    	</logger>
    	<!--
    		Suppressing the output of the PDFBox & FontBox WARN log when a PDF file is stored in the repository
    	-->
    	<logger name="org.apache.pdfbox" additivity="false" level="ERROR">
    		<appender-ref ref="ROOT" />
    	</logger>
    	<logger name="org.apache.fontbox" additivity="false" level="ERROR">
    		<appender-ref ref="ROOT" />
    	</logger>