logback常用配置及标签使用说明

 

<?xml version="1.0" encoding="UTF-8"?>
<!--
	configuration有三个常用属性：scan="true" scanPeriod="60 seconds" debug="false"
	scan：当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true。
	scanPeriod： 置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。
			当scan为true时，此属性生效。默认的时间间隔为1分钟。
	debug： 当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。
	-->
<configuration>

    <!--设置变量<property>  有两个属性，name和value；其中name的值是变量的名称，value的值时变量定义的值。
    通过<property>定义的值会被插入到logger上下文中。定义变量后，可以使“${}”来使用变量。-->
    <!-- 日志路径变量-->
    <property name="log.path" value="./logs" />
    <!--
        	日志输出格式：
            %d表示日期时间，
            %thread表示线程名，
            %-5level：级别从左显示5个字符宽度
            %logger{20} 表示logger名字最长20个字符，否则按照句点分割。
            %method日志请求的方法名
            %line日志请求的行号
            %msg：日志消息，
            %n是换行符
        -->
    <!-- 日志输出格式变量 -->
    <property name="log.pattern" value="%d{HH:mm:ss.SSS} [%thread] %-5level %logger{20} - [%method,%line] - %msg%n" />


    <!--
		appender 负责写日志的组件，它有两个必要属性name和class。name指定appender名称，class指定appender的全限定名

		appender class 类型主要有三种：ConsoleAppender、FileAppender、RollingFileAppender
			ConsoleAppender 把日志输出到控制台，有以下子节点：
				<encoder>：对日志进行格式化。（具体参数稍后讲解 ）
				<target>：字符串System.out(默认)或者System.err（区别不多说了）
			FileAppender：把日志添加到文件，有以下子节点：
			   <file>：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。
			   <append>：如果是 true，日志被追加到文件结尾，如果是 false，清空现存文件，默认是true。
			   <encoder>：对记录事件进行格式化。（具体参数稍后讲解 ）
			   <prudent>：如果是 true，日志会被安全的写入文件，即使其他的FileAppender也在向此文件做写入操作，效率低，默认是 false。
			RollingFileAppender：滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件。有以下子节点：
				<file>：被写入的文件名，可以是相对目录，也可以是绝对目录，如果上级目录不存在会自动创建，没有默认值。
				<append>：如果是 true，日志被追加到文件结尾，如果是 false，清空现存文件，默认是true。
				<rollingPolicy>:当发生滚动时，决定RollingFileAppender的行为，涉及文件移动和重命名。属性class定义具体的滚动策略类
	-->

    <!-- 控制台输出 -->
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <!--encoder一是用于将日志信息转为字节数组，二是将字节数组写入到输入流-->
        <encoder>
            <!--pattern是用于控制日志的输出格式。-->
            <pattern>${log.pattern}</pattern>
        </encoder>
    </appender>

    <!-- 系统日志输出 -->
    <appender name="info_and_warn" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!--指定日志文件名称-->
        <file>${log.path}/info-and-warn.log</file>
        <!-- 如果是 true，日志被追加到文件结尾，如果是 false，清空现存文件，默认是true。 -->
　　　　<append>true</append>
        <!--
	       	 循环政策：基于时间创建日志文件，当发生滚动时，决定 RollingFileAppender 的行为，涉及文件移动和重命名
	        TimeBasedRollingPolicy： 最常用的滚动策略，它根据时间来制定滚动策略，既负责滚动也负责出发滚动。
        -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--
            	滚动时产生的文件的存放位置及文件名称 %d{yyyy-MM-dd}：按天进行日志滚动
            	%i：当文件大小超过maxFileSize时，按照i进行文件滚动
            -->
            <fileNamePattern>${log.path}/info-and-warn.%d{yyyy-MM-dd}-%i.log</fileNamePattern>
            <!--
                可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件。假设设置每天滚动，
                且maxHistory是60，则只保存最近60天的文件，删除之前的旧文件。注意，删除旧文件是时，
                那些为了归档而创建的目录也会被删除。
            -->
            <!-- 日志最大的历史 60天 -->
            <maxHistory>60</maxHistory>
            <!--
                当日志文件超过maxFileSize指定的大小时，根据上面提到的%i进行日志文件滚动
                注意此处配置SizeBasedTriggeringPolicy是无法实现按文件大小进行滚动的，必须配置timeBasedFileNamingAndTriggeringPolicy
            -->
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>2KB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder>
            <pattern>${log.pattern}</pattern>
        </encoder>
        
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 过滤的级别 -->
            <level>INFO</level>
            <!-- 匹配时的操作：接收（记录） -->
            <onMatch>ACCEPT</onMatch>
            <!-- 不匹配时的操作：下个过滤器接收（不记录） -->
            <onMismatch>NEUTRAL</onMismatch>
        </filter>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 过滤的级别 -->
            <level>WARN</level>
            <!-- 匹配时的操作：接收（记录） -->
            <onMatch>ACCEPT</onMatch>
            <!-- 不匹配时的操作：拒绝（不记录） -->
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>

    <appender name="only_error" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <file>${log.path}/only-error.log</file>
        <!-- 循环政策：基于时间创建日志文件 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!-- 日志文件名格式 -->
            <fileNamePattern>${log.path}/only-error.%d{yyyy-MM-dd}-%i.log</fileNamePattern>
            <!-- 日志最大的历史 60天 -->
            <maxHistory>60</maxHistory>
            <timeBasedFileNamingAndTriggeringPolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedFNATP">
                <maxFileSize>50MB</maxFileSize>
            </timeBasedFileNamingAndTriggeringPolicy>
        </rollingPolicy>
        <encoder>
            <pattern>${log.pattern}</pattern>
        </encoder>
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 过滤的级别 -->
            <level>ERROR</level>
            <!-- 匹配时的操作：接收（记录） -->
            <onMatch>ACCEPT</onMatch>
            <!-- 不匹配时的操作：拒绝（不记录） -->
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>



    <!-- 系统模块日志级别控制  -->
    <logger name="xyz.hashdog" level="info" />
    <!-- Spring日志级别控制  -->
    <logger name="org.springframework" level="warn" />
    <root level="info">
        <appender-ref ref="console" />
    </root>

    <!--系统操作日志-->
    <root level="info">
        <appender-ref ref="info_and_warn" />
        <appender-ref ref="only_error" />
    </root>

</configuration>

filter标签使用详细：https://blog.csdn.net/corleone_4ever/article/details/104296030

常用标签使用详细：https://blog.csdn.net/corleone_4ever/article/details/104295928