Spring Bootでlogback-spring.xmlを使ったロガーの設定

どうも高妻です。Twitterでプログラミングのことや暗号通貨のことをつぶやいているのでよかったらフォローしてください。Follow @Tomokazu106

Spring Bootでのロガー設定方法

Spring Bootではspring-boot-starter-webを使用するとLogbackがデフォルトで使えるようになります。Logbackの設定は慣れると簡単にロガーの設定ができます。Spring Bootを使ってるならこれで事足りると思います。

設定方法

logback-spring.xmlはapplication.propertiesがあるresources配下に作成します。中身はこんな感じです。上から順番に説明して行きます。

<?xml version="1.0" encoding="UTF-8"?>
<configuration>

    <!-- デフォルト設定読み込み -->
    <include resource="org/springframework/boot/logging/logback/base.xml" />

    <property name="logFileName" value="app" />

    <!--ローカル環境用設定 -->
    <springProfile name="default">
        <property name="logFilePath" value="./" />
    </springProfile>

    <!--develop環境用設定 -->
    <springProfile name="develop">
        <property name="logFilePath" value="/var/log/mercury/" />
    </springProfile>

    <!--production環境用設定 -->
    <springProfile name="production">
        <property name="logFilePath" value="/var/log/mercury/" />
    </springProfile>

    <!-- コンソール出力 -->
    <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
        <target>System.out</target>
        <encoder>
            <charset>UTF-8</charset>
            <pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- アプリケーションログのファイル書き出し -->
    <appender name="APPLIATION_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!--ファイル名 -->
        <file>${logFilePath}${logFileName}.log</file>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${logFilePath}${logFileName}-%d{yyyy-MM-dd}.log.zip</fileNamePattern>
            <maxHistory>3</maxHistory>
        </rollingPolicy>
        <encoder>
            <charset>UTF-8</charset>
            <pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>
        </encoder>
    </appender>

    <!--rootログレベルと使用出力ルール -->
    <root level="INFO">
        <appender-ref ref="APPLIATION_LOG" />
    </root>
</configuration>

<?xml version="1.0" encoding="UTF-8"?>

</springProfile>

</springProfile>

</springProfile>

<target>System.out</target>

<pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>

</encoder>

</appender>

<file>${logFilePath}${logFileName}.log</file>

<fileNamePattern>${logFilePath}${logFileName}-%d{yyyy-MM-dd}.log.zip</fileNamePattern>

</rollingPolicy>

<pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>

</encoder>

</appender>

<appender-ref ref="APPLIATION_LOG" />

</root>

</configuration>

デフォルト設定

インクルードしているのはコンソールとファイル用のアペンダーになります。詳細はこちら。

<!-- デフォルト設定読み込み -->
<include resource="org/springframework/boot/logging/logback/base.xml" />

1 2	<!-- デフォルト設定読み込み --> <include resource="org/springframework/boot/logging/logback/base.xml" />

環境別変数の設定

環境別に変数を定義することができます。springProfileは起動時に指定しているapplication-develop.propertiesやapplication-production.propertiesの環境名を指定できます。

<!--ローカル環境用設定 -->
<springProfile name="default">
    <property name="logFilePath" value="./" />
</springProfile>

<!--develop環境用設定 -->
<springProfile name="develop">
    <property name="logFilePath" value="/var/log/mercury/" />
</springProfile>

</springProfile>

</springProfile>

コンソールアペンダー

コンソールにログを出力するときのフォーマットを設定できます。

 <!-- コンソール出力 -->
<appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
    <target>System.out</target>
    <encoder>
        <charset>UTF-8</charset>
        <pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>
    </encoder>
</appender>

<target>System.out</target>

<pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>

</encoder>

</appender>

ファイル書き出し

ファイル書き出しのフォーマットとローテションの設定ができます。ローテーションは日毎にzipで圧縮もできるし、保存期間も簡単に設定できるので便利です。下記では保存期間を3日で設定しています。

<!-- アプリケーションログのファイル書き出し -->
<appender name="APPLIATION_LOG" class="ch.qos.logback.core.rolling.RollingFileAppender">
    <!--ファイル名 -->
    <file>${logFilePath}${logFileName}.log</file>
    <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
        <fileNamePattern>${logFilePath}${logFileName}-%d{yyyy-MM-dd}.log.zip</fileNamePattern>
        <maxHistory>3</maxHistory>
    </rollingPolicy>
    <encoder>
        <charset>UTF-8</charset>
        <pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>
    </encoder>
</appender>

<file>${logFilePath}${logFileName}.log</file>

<fileNamePattern>${logFilePath}${logFileName}-%d{yyyy-MM-dd}.log.zip</fileNamePattern>

</rollingPolicy>

<pattern>%d{yyyy/MM/dd HH:mm:ss} %-5level [%thread] - %msg%n</pattern>

</encoder>

</appender>

ログレベル設定

最後に出力するログレベルと使用するアペンダーを指定すれば完了です。

<!--rootログレベルと使用出力ルール -->
<root level="INFO">
    <appender-ref ref="APPLIATION_LOG" />
</root>

<appender-ref ref="APPLIATION_LOG" />

</root>

この記事を書いた人
最新の記事

高妻智一

2013年CyberAgent新卒入社スマホゲームを作る子会社に所属し、サーバーサイドのエンジニアを担当。２年目の終わりから新規子会社の立ち上げに参加し、サーバーサイドのエンジニアリーダーとしてサービースのリリースから運用までを担当。現在はTwitterなどSNSのテキスト解析を行うソーシャルメディア分析のサーバーサイドを開発中。言語はNode.js、Kotlinを使用。