核心
- 通过合理配置多个 appender 来定义不同的日志输出目的地
- 通过 logger 元素将不同的包与对应的 appender 关联起来
- 同时利用 additivity 属性控制日志的传递,从而实现精准的日志输出管理。
additivity 属性控制日志传递:
additivity 属性决定了该 logger 的日志是否会传递给父 logger。将其设置为 false 时,该 logger 的日志只会输出到与之关联的 appender,不会再传递给根 logger,从而保证不同包的日志能准确输出到各自对应的文件。
appender-ref 关联 appender:通过 appender-ref 元素将 logger 与特定的 appender 关联起来。例如 表示将 com.example.package1 包的日志输出到 PACKAGE1_FILE appender 对应的文件。
xml定义
<configuration>
<!-- 控制台输出 appender -->
<appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<!-- 包1的文件输出 appender -->
<appender name="PACKAGE1_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>logs/package1.log</file>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>logs/package1.%d{yyyy-MM-dd}.log</fileNamePattern>
<maxHistory>30</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<!-- 包2的文件输出 appender -->
<appender name="PACKAGE2_FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
<file>logs/package2.log</file>
<rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
<fileNamePattern>logs/package2.%d{yyyy-MM-dd}.log</fileNamePattern>
<maxHistory>30</maxHistory>
</rollingPolicy>
<encoder>
<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg%n</pattern>
</encoder>
</appender>
<!-- 根 logger,输出到控制台 -->
<root level="info">
<appender-ref ref="CONSOLE" />
</root>
<!-- 包1的 logger,输出到对应的文件 -->
<logger name="log-package1" level="debug" additivity="false">
<appender-ref ref="PACKAGE1_FILE" />
</logger>
<!-- 包2的 logger,输出到对应的文件 -->
<logger name="log-package2" level="debug" additivity="false">
<appender-ref ref="PACKAGE2_FILE" />
</logger>
</configuration>
Java代码
在定义logger处指定名称
private static final Logger logger = LoggerFactory.getLogger("log-package1");
private static final Logger logger = LoggerFactory.getLogger("log-package1");
拓展
Logger 的 name 属性的作用
- name 属性的作用
层次结构标识:Logger 名称采用点分层次结构(如 “com.example.service”),形成父子关系
日志路由:决定哪些日志事件由哪个 Logger 处理
继承配置:子 Logger 可以继承父 Logger 的配置
- 命名规则
- 通常使用类的全限定名作为 Logger 名称(惯例)
private static final Logger logger = LoggerFactory.getLogger(MyClass.class);
也可以是任意有意义的字符串名称
区分大小写
- 继承机制
子 Logger 会继承父 Logger 的:
- 日志级别(如果子 Logger 未显式设置)
- Appender(除非设置 additivity=“false”)
- 特殊的
root
Logger
- 名称固定为 “ROOT”
- 所有 Logger 的最终父节点
- 必须配置,通常作为默认日志处理者
- 不可以配置多个,官方文档明确指出 “配置中只能有一个 root logger”,但实现上选择了"最后生效"的宽松处理方式
<root level="INFO">
<appender-ref ref="CONSOLE"/>
</root>
实例
<!--根,默认日志处理器-->
<root level="info">
<appender-ref ref="file_info" />
<appender-ref ref="file_error" />
<appender-ref ref="console" />
</root>
<!--子,设定不同日志级别-->
<logger name="com.ruoyi" level="info" />
<logger name="org.springframework" level="warn" />
<!--相对独立的user日志-->
<logger name="sys-user" level="info" addativity="false">
<appender-ref ref="sys-user"/>
</logger>