目录
控制台附加器:ch.qos.logback.core.ConsoleAppender
文件附加器: ch.qos.logback.core.FileAppender
滚动文件附加器:ch.qos.logback.core.rolling.RollingFileAppender
根据阿里云开发规范,日志的记录最好分成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
说明:
- 如果记录器未设置level属性,则该纪录器的级别从上级记录器继承
- 如果想查看记录器的级别,应该通过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
滚动策略
- 基于时间的滚动策略
ch.qos.logback.core.rolling.TimeBasedRollingPolicy
- 基于时间和大小的滚动策略
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去配置一下该文件的目录。