logback.xml详解(赋阿里云规范实例)

目录

日志级别

记录器Logger

如何生成记录器:

每个记录器Logger的属性

name属性:

level属性(可选):

additivity属性(可选):

说明:

附加器Appender

常用的附加器

Pattern标签

控制台附加器:ch.qos.logback.core.ConsoleAppender

文件附加器: ch.qos.logback.core.FileAppender

滚动文件附加器:ch.qos.logback.core.rolling.RollingFileAppender

过滤器

常用过滤器

记录器可加性additivity

SpringBoot中使用logback

 

 根据阿里云开发规范,日志的记录最好分成error, debug,info. 分开记录。按天生成。这样就比较方便问题定位查找。下面附上配置


<?xml version="1.0" encoding="UTF-8"?>
<configuration>
 
    <!-- 应用名称:和统一配置中的项目代码保持一致(小写) -->
    <property name="APP_NAME" value="app"/>
    <contextName>${APP_NAME}</contextName>
    <!--日志文件保留天数 -->
    <property name="LOG_MAX_HISTORY" value="30"/>
    <!--定义日志文件的存储地址 勿在 LogBack 的配置中使用相对路径 -->
 
    <!--应用日志文件保存路径 -->
    <!--在没有定义${LOG_HOME}系统变量的时候,可以设置此本地变量。提交测试、上线时,要将其注释掉,使用系统变量。 -->
    <property name="LOG_HOME" value="logs/${APP_NAME}"/>
    <!--<property name="LOG_HOME" msg="/home/logs/${APP_NAME}" />-->
 
    <!--=========================== 按照每天生成日志文件:默认配置=================================== -->
    <!-- 控制台输出 -->
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化输出:%d表示日期,%c类名,%t表示线程名,%L行, %p日志级别 %msg:日志消息,%n是换行符  -->
            <pattern>%black(%contextName - %d{yyyy-MM-dd HH:mm:ss}) %green([%c][%t][%L]) %highlight(%-5level) - %gray(%msg%n)</pattern>
        </encoder>
    </appender>
 
    <!-- 按照每天生成日志文件:主项目日志 -->
    <appender name="APP_DEBUG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志文件输出的文件名 -->
            <FileNamePattern>${LOG_HOME}/debug-%d{yyyy-MM-dd}.log</FileNamePattern>
            <!--日志文件保留天数 -->
            <MaxHistory>${LOG_MAX_HISTORY}</MaxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化输出:%d表示日期,%c类名,%t表示线程名,%L行, %p日志级别 %msg:日志消息,%n是换行符  -->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%c][%t][%L][%p] - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <!-- 此日志文件只记录debug级别的 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>debug</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>
 
    <!-- 按照每天生成日志文件:主项目日志 -->
    <appender name="APP_INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志文件输出的文件名 -->
            <FileNamePattern>${LOG_HOME}/info-%d{yyyy-MM-dd}.log</FileNamePattern>
            <!--日志文件保留天数 -->
            <MaxHistory>${LOG_MAX_HISTORY}</MaxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化输出:%d表示日期,%c类名,%t表示线程名,%L行, %p日志级别 %msg:日志消息,%n是换行符  -->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%c][%t][%L][%p] - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
 
        <!-- 此日志文件只记录info级别的 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>info</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>
 
    <!-- 按照每天生成日志文件:主项目日志 -->
    <appender name="APP_ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志文件输出的文件名 -->
            <FileNamePattern>${LOG_HOME}/error-%d{yyyy-MM-dd}.log</FileNamePattern>
            <!--日志文件保留天数 -->
            <MaxHistory>${LOG_MAX_HISTORY}</MaxHistory>
        </rollingPolicy>
        <encoder class="ch.qos.logback.classic.encoder.PatternLayoutEncoder">
            <!--格式化输出:%d表示日期,%c类名,%t表示线程名,%L行, %p日志级别 %msg:日志消息,%n是换行符  -->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%c][%t][%L][%p] - %msg%n</pattern>
            <charset>UTF-8</charset>
        </encoder>
        <!-- 此日志文件只记录error级别的 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>error</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
    </appender>
 
    <!--日志输出到文件-->
    <root level="info">
        <appender-ref ref="APP_DEBUG"/>
        <appender-ref ref="APP_INFO"/>
        <appender-ref ref="APP_ERROR"/>
        <appender-ref ref="console"/>
    </root>
 
    <!-- mybatis 日志级别 -->
    <logger name="com.xxx" level="debug"/>
</configuration>

日志级别

java日志共分为五个级别

等级排序为: TRACE < DEBUG < INFO < WARN < ERROR

记录器Logger

日志记录器: 控制要输出哪些日志记录语句,对日志信息进行级别限制,

如何生成记录器:

final static Logger logger = LoggerFactory.getLogger("名称");

每个记录器Logger的属性

name属性:

记录器的名称

level属性(可选):

记录器的级别,允许的级别从低到高TRACE < DEBUG < INFO < WARN < ERROR

logger.setLevel()

logger.getLevel();

logger.getEffectiveLevel()

additivity属性(可选):

是否允许叠加打印日志,true或false

说明:

  1. 如果记录器未设置level属性,则该纪录器的级别从上级记录器继承
  2. 如果想查看记录器的级别,应该通过logger.getEffectiveLevel()方法,同时要将Logger转为ch.qos.logback.classic.Logger类型,如下:
ch.qos.logback.classic.Logger logger =

(ch.qos.logback.classic.Logger) LoggerFactory.getLogger(App.class);

附加器Appender

记录器会将输出日志的任务交给附加器完成,不同的附加器会将日志输出到不同的地方,比如控制台附加器、文件附加器、网络附加器等等。

常用的附加器

  • 控制台附加器: ch.qos.logback.core.ConsoleAppender
  • 文件附加器: ch.qos.logback.core.FileAppender
  • 滚动文件附加器: ch.qos.logback.core.rolling.RollingFileAppender

Pattern标签

pattern由文字文本(abcd……)转换说明符(%date %msg ……)的格式控制表达式组成,可以向其中自由插入任何文字文本。每个转换说明符都以百分号‘%’后跟可选的 格式修饰符、转换字和大括号之间的可选参数。转换字控制要转换的数据字段,例如记录器的名称、级别、日期和线程名称。格式修饰符控制字段长度、填充以及左对齐或右对齐。

控制台附加器:ch.qos.logback.core.ConsoleAppender

文件附加器: ch.qos.logback.core.FileAppender

文件附加器的缺点:

我们知道我们打印的所有的日志信息都会存储到logs的文件中,该动作并不会考虑该文件的容量和大小,只要有,就往里塞。就会导致日志文件臃肿和日志信息查询繁琐的问题。

所以推荐使用滚动文件附加器: ch.qos.logback.core.rolling.RollingFileAppender

滚动文件附加器:ch.qos.logback.core.rolling.RollingFileAppender

滚动策略

  1. 基于时间的滚动策略

ch.qos.logback.core.rolling.TimeBasedRollingPolicy

  1. 基于时间和大小的滚动策略

ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy

值得注意的是:

在时间空间策略中,<maxHistory>3</maxHistory>所表示的内容不是文件的最大数量,而是文件生成格式的最小单位时间的区间。

例如:我在2月28日看我的日志文件,那么日志文件只保留26、27、28这三天的日志信息。

过滤器

常用过滤器

LevelFilter(级别过滤器):实现类 ch.qos.logback.classic.filter.LevelFilter

ThresholdFilter(阈值过滤器):实现类 ch.qos.logback.classic.filter.ThresholdFilter

EvaluatorFilter(评估者过滤器):实现类 ch.qos.logback.classic.filter.EvaluatorFilter

JaninoEventEvaluator过滤器:实现类 ch.qos.logback.classic.filter.EvaluatorFilter

TurboFilter涡轮过滤器

DuplicateMessageFilter 重复消息过滤器

记录器可加性additivity

如图所示:我定义了两个记录器,root是根记录器,c.karami是子记录器。当两个记录器用同一个附加器时,就会打印两条相同的个日志文件。如图:

如果我们不想让控制台输出相同的日志信息,只需要在记录器中添加一个属性 additivity = "false"即可。如图

SpringBoot中使用logback

在sp中使用logback没有什么要注意的点,如果你想要将logback.xml文件重新命名为其他的名字,只需要在application.yml去配置一下该文件的目录。

  • 1
    点赞
  • 4
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值