在java日志记录中配置日志文件滚动策略,核心是定义触发滚动的条件(如文件大小或时间)以及保留文件的数量。以logback为例,通过配置rollingfileappender并绑定timebasedrollingpolicy或sizeandtimebasedrollingpolicy即可实现自动归档。设置好filenamepattern指定归档路径和命名规则后,日志会在达到阈值时自动切割并压缩旧文件。

如何按时间和大小组合滚动日志
按时间和大小组合滚动需要同时启用时间滚动和大小限制。使用SizeAndTimeBasedRollingPolicy可以确保每天生成一个新文件,且单个文件不超过指定大小。这种策略适合既需要按天归档又希望控制单文件体积的场景。

<configuration><appender name="ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>logs/app.log</file><rollingpolicy class="ch.qos.logback.core.rolling.SizeAndTimeBasedRollingPolicy"><filenamepattern>logs/app.%d{yyyy-MM-dd}.%i.log.gz</filenamepattern><maxfilesize>10MB</maxfilesize><maxhistory>30</maxhistory><totalsizecap>1GB</totalsizecap></rollingpolicy><encoder><pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern></encoder></appender><root level="INFO"><appender-ref ref="ROLLING"></appender-ref></root></configuration>
上述配置中,fileNamePattern包含%i用于处理同一天内多次滚动的情况。maxHistory设置为30表示保留30天的日志。totalSizeCap限制所有历史日志的总大小。当单文件达到10MB时,即使未到午夜也会触发滚动,并在文件名后增加索引%i。
如何仅按时间滚动并清理旧日志
仅按时间滚动是最常见的配置方式,适用于不需要严格限制单文件大小但需定期归档的场景。使用TimeBasedRollingPolicy并指定fileNamePattern中的日期格式,日志会按天、小时等周期自动分割。配合maxHistory可自动删除过期文件。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

<configuration><appender name="TIME_ROLLING" class="ch.qos.logback.core.rolling.RollingFileAppender"><file>logs/service.log</file><rollingpolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy"><filenamepattern>logs/service.%d{yyyy-MM-dd}.log</filenamepattern><maxhistory>7</maxhistory><cleanhistoryonstart>true</cleanhistoryonstart></rollingpolicy><encoder><pattern>%-4relative [%thread] %-5level %logger{35} - %msg%n</pattern></encoder></appender><root level="DEBUG"><appender-ref ref="TIME_ROLLING"></appender-ref></root></configuration>
该配置中,maxHistory设为7,意味着只保留最近7天的日志文件。启动时cleanHistoryOnStart为true会清理启动前可能存在的过期文件。文件名模式%d{yyyy-MM-dd}确保每天产生一个独立日志文件。若需更细粒度如每小时滚动,可将格式改为%d{yyyy-MM-dd-HH}。
日志滚动时文件名中的%i变量作用是什么
在SizeAndTimeBasedRollingPolicy中,%i变量用于区分同一时间段内因大小限制而触发的多次滚动。当单文件达到maxFileSize上限时,系统不会覆盖原文件,而是递增%i的值生成新文件,如app.2023-10-01.0.log、app.2023-10-01.1.log。这避免了数据丢失,并确保每个滚动片段都有唯一标识。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










