Java：Logback中AsyncAppender的使用说明

太过爱你忘了你带给我的痛 2022-10-16 06:17 372阅读 0赞

在打印日志时，为了提高当前线程的执行效率，一般会将需要打印的内容交由专门的日志线程进行打印，比如Logback中会使用AsyncAppender。

AsyncAppender配置说明

**目录**

1.队列容量配置

2.队列剩余容量的不同行为

3.队列满时会阻塞

4.应用停止时清理队列

5.LoggerContext停止方式

--------------------

### 1.队列容量配置 ###

Logback使用BlockingQueue存放业务线程的打印内容，AsyncAppender会从此队列中取内容。队列默认大小为256，可使用参数如下进行配置。

> 500

### 2.队列剩余容量的不同行为 ###

默认情况下，当队列剩余容量小于总容量的20%时，日志级别<=INFO的内容将不会打印，只会打印WARN、ERROR级别的内容。可以设置如下参数改变默认配置：

默认情况下，discardingThreshold 的值为：discardingThreshold = queueSize / 5

比如，queueSize=500，则discardingThreshold 的取值范围： 0 <= discardingThreshold <= 500。

discardingThreshold =0时，表示剩余容量在小于0%的时候，日志级别<=INFO的内容才不会打印；但剩余容量最少也只会等于0%，不会小于0%，所以在此情况下所有日志级别都会打印。

discardingThreshold =500时，表示剩余容量在小于100%的时候，日志级别<=INFO的内容不会打印；所以此情况下只会打印WARN、ERROR级别的内容。

### 3.队列满时会阻塞 ###

当队列满了时，会阻塞业务线程，此时异步处理会变成同步等待；只有队列有可用容量时，业务线程才从阻塞状态恢复。

### 4.应用停止时清理队列 ###

当`LoggerContext`停止时，由于队列中还会有没有打印的日志内容，因此需要等待一段时间，等待队列处理完毕。配置参数如下：

默认值为1000ms。如果队列较大，队列内容较多，可以将此值设置的较大。如果超过此时间队列中的日志还没有处理完毕，则队列中的日志将抛弃。

### 5.`LoggerContext`停止方式 ###

1）使用代码实现

在应用停止做收尾处理的时候添加如下代码：

> LoggerContext loggerContext = (LoggerContext) LoggerFactory.getILoggerFactory();  
> loggerContext.stop();

2）在logback.xml中配置

此时会在JVM上注册一个Hook，当JVM停止时，会调用loggerContext.stop();

3）在web容器环境

1.1.10以上版本提供了LogbackServletContainerInitializer，它已在logback-classic.jar中如下路径进行了配置，web容器会自动加载。当web容器停止时，也会自动loggerContext.stop();

> /META-INF/services/javax.servlet.ServletContainerInitializer

参考文档

[Chapter 3: Logback configuration][Chapter 3_ Logback configuration]  
[Chapter 4: Appenders][Chapter 4_ Appenders]

[Chapter 3_ Logback configuration]: https://logback.qos.ch/manual/configuration.html#webShutdownHook
[Chapter 4_ Appenders]: https://logback.qos.ch/manual/appenders.html

发表评论取消回复

表情：

评论列表（有 0 条评论，372人围观）

还没有评论，来说两句吧...

相关阅读

相关 idea中git的使用详细说明

一.克隆项目 1. 打开File>New>Project from Version Control... ![2680189bc4b5434a891d392abec7fc

小咪咪/ 2024年03月17日 00:15/ 0 赞/ 95 阅读

相关 js中eval()的使用说明

今天写小游戏sdk的时候，对方调用我的方法，然后传了个方法过来，我用eval判断了一下传过来的是否是function，但是结果出错了，于是想弄明白eval究竟是怎么使用的，查了

r囧r小猫/ 2023年01月09日 03:41/ 0 赞/ 168 阅读

相关 Java：Logback中AsyncAppender的使用说明

在打印日志时，为了提高当前线程的执行效率，一般会将需要打印的内容交由专门的日志线程进行打印，比如Logback中会使用AsyncAppender。 AsyncAppender

太过爱你忘了你带给我的痛/ 2022年10月16日 06:17/ 0 赞/ 373 阅读

相关 hibernate中@MappedSuperclass注解的使用说明

基于代码复用和模型分离的思想，在项目开发中使用JPA的@MappedSuperclass注解将实体类的多个属性分别封装到不同的非实体类中。 1. @MappedSu

╰+攻爆jí腚メ/ 2022年06月04日 00:25/ 0 赞/ 265 阅读

相关 numpy中的tile函数的使用说明

numpy中的tile函数网上讲解的有很多，但大概都是一带而过，这里参照[官方文档][Link 1]进行一下说明。 > def tile(A, reps): > “””

待我称王封你为后i/ 2022年05月27日 00:55/ 0 赞/ 241 阅读

相关 OpenLayers中TileWMS和ImageWMS的使用说明

GeoServer中发布的WMS服务，使用OpenLayers显示后，发现加载的地图是切片的，这让我很疑惑：是GeoServer中发布的WMS服务有问题，还是OpenLayer

本是古典何须时尚/ 2022年05月24日 03:11/ 0 赞/ 1213 阅读

相关 mySql中IFNULL的使用说明

[mySql中IFNULL的使用说明][mySql_IFNULL] IFNULL(expr1,expr2) 如果expr1不是NULL，IFNULL()返回expr1，

分手后的思念是犯贱/ 2022年03月19日 01:08/ 0 赞/ 252 阅读

相关 mySql中IFNULL的使用说明

IFNULL(expr1,expr2) 如果expr1不是NULL，IFNULL()返回expr1，否则它返回expr2。IFNULL()返回一个数字或字符串值具体用法如

我会带着你远行/ 2022年03月08日 04:40/ 0 赞/ 265 阅读

相关 delphi中SendMessage使用说明

SendMessage基础知识函数功能：该函数将指定的消息发送到一个或多个窗口。此函数为指定的窗口调用窗口程序，直到窗口程序处理完消息再返回。而函数PostMessage不同

向右看齐/ 2021年11月22日 16:06/ 0 赞/ 435 阅读

相关 android 中junit的使用说明

在javase/ee 的开发中，我们对业务方法的测试一般使用“main函数”的方法，也可以使用junit的方法。在android环境下，由于程序运行在Dalvi

亦凉/ 2021年09月10日 08:44/ 0 赞/ 346 阅读