logback.xml配置详解

最新推荐文章于 2025-05-22 14:34:06 发布
最新推荐文章于 2025-05-22 14:34:06 发布
阅读量609 收藏 2
点赞数
CC 4.0 BY-SA版权
分类专栏： Java Web 文章标签： logback 日志配置
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/weixin_43611145/article/details/96877513
本文详细介绍了logback.xml的配置，包括配置文件的默认加载位置、configuration节点属性、contextName、property、appender和logger节点的详细解析，帮助读者深入理解并有效配置logback日志系统。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

logback.xml配置详解

相关文章链接：

SSM框架搭建Web项目

相关文章链接 第3节 日志配置

Jar包下载链接

1.简介

Logback是由log4j创始人设计的又一个开源日志组件。logback当前分成三个模块：logback-core，logback- classic和logback-access。

  1. logback-core是其它两个模块的基础模块。

  2. logback-classic是log4j的一个 改良版本。此外logback-classic完整实现SLF4J API使你可以很方便地更换成其它日志系统如log4j或JDK14 Logging。

  3. logback-access访问模块与Servlet容器集成提供通过Http来访问日志的功能。

2.配置文件默认加载位置

  1. classpath下的logback.groovy。

  2. classpath下的logback-test.xml。

  3. classpath下的logback.xml。

  4. 如果是 jdk6+，那么会调用ServiceLoader 查找 META-INF/services/ch.qos.logback.classic.spi.Configurator中的 logback 配置实现类。

  5. 使用ch.qos.logback.classic.BasicConfigurator，在控制台输出日志。

3.代码样例

<?xml version="1.0" encoding="UTF-8"?>
<!-- 级别从高到低 OFF 、 FATAL 、 ERROR 、 WARN 、 INFO 、 DEBUG 、 TRACE 、 ALL -->
<!-- 日志输出规则 根据当前ROOT 级别，日志输出时，级别高于root默认的级别时 会输出 -->
<!-- 以下 每个配置的 filter 是过滤掉输出文件里面，会出现高级别文件，依然出现低级别的日志信息，通过filter 过滤只记录本级别的日志 -->
<!-- scan 当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true。 -->
<!-- scanPeriod 设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。当scan为true时，此属性生效。默认的时间间隔为1分钟。 -->
<!-- debug 当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。 -->
<configuration scan="true" scanPeriod="60 seconds" debug="false">
    <!-- 动态日志级别 -->
    <jmxConfigurator />
    <!-- 定义日志文件 输出位置 -->
    <property name="log_dir" value="D:/logbacks" />
    <!-- 日志最大的历史 30天 -->
    <property name="maxHistory" value="30" />

    <!-- ConsoleAppender 控制台输出日志 -->
    <appender name="console" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <pattern>
                <!-- 设置日志输出格式 -->
                %d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %logger - %msg%n
            </pattern>
        </encoder>
    </appender>

    <!-- ERROR级别日志 -->
    <!-- 滚动记录文件，先将日志记录到指定文件，当符合某个条件时，将日志记录到其他文件 RollingFileAppender -->
    <appender name="ERROR" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤器，只记录ERROR级别的日志 -->
        <!-- 果日志级别等于配置级别，过滤器会根据onMath 和 onMismatch接收或拒绝日志。 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 设置过滤级别 -->
            <level>ERROR</level>
            <!-- 用于配置符合过滤条件的操作 -->
            <onMatch>ACCEPT</onMatch>
            <!-- 用于配置不符合过滤条件的操作 -->
            <onMismatch>DENY</onMismatch>
        </filter>
        <!-- 最常用的滚动策略，它根据时间来制定滚动策略.既负责滚动也负责出发滚动 -->
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志输出位置 可相对、和绝对路径 -->
            <fileNamePattern>
                ${log_dir}/error/%d{yyyy-MM-dd}/error-log.log
            </fileNamePattern>
            <!-- 可选节点，控制保留的归档文件的最大数量，超出数量就删除旧文件假设设置每个月滚动，且<maxHistory>是6， 则只保存最近6个月的文件，删除之前的旧文件。注意，删除旧文件是，那些为了归档而创建的目录也会被删除 -->
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>
                <!-- 设置日志输出格式 -->
                %d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %logger - %msg%n
            </pattern>
        </encoder>
    </appender>

    <!-- WARN级别日志 appender -->
    <appender name="WARN" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <!-- 过滤器，只记录WARN级别的日志 -->
        <!-- 果日志级别等于配置级别，过滤器会根据onMath 和 onMismatch接收或拒绝日志。 -->
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <!-- 设置过滤级别 -->
            <level>WARN</level>
            <!-- 用于配置符合过滤条件的操作 -->
            <onMatch>ACCEPT</onMatch>
            <!-- 用于配置不符合过滤条件的操作 -->
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志输出位置 可相对、和绝对路径 -->
            <fileNamePattern>${log_dir}/warn/%d{yyyy-MM-dd}/warn-log.log</fileNamePattern>
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %logger - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- INFO级别日志 appender -->
    <appender name="INFO" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>INFO</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${log_dir}/info/%d{yyyy-MM-dd}/info-log.log</fileNamePattern>
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %logger - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- DEBUG级别日志 appender -->
    <appender name="DEBUG" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>DEBUG</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${log_dir}/debug/%d{yyyy-MM-dd}/debug-log.log</fileNamePattern>
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %logger - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- TRACE级别日志 appender -->
    <appender name="TRACE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <filter class="ch.qos.logback.classic.filter.LevelFilter">
            <level>TRACE</level>
            <onMatch>ACCEPT</onMatch>
            <onMismatch>DENY</onMismatch>
        </filter>
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <fileNamePattern>${log_dir}/trace/%d{yyyy-MM-dd}/trace-log.log</fileNamePattern>
            <maxHistory>${maxHistory}</maxHistory>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} %-5level %logger - %msg%n</pattern>
        </encoder>
    </appender>
    
     <logger name="org.springframework">
        <level value="DEBUG" />
        <appender-ref ref="${log.appender:-DEBUG}" />
    </logger>

    <!-- root级别 DEBUG -->
    <root>
        <!-- 打印debug级别日志及以上级别日志 -->
        <level value="debug" />
        <!-- 控制台输出 -->
        <appender-ref ref="console" />
        <!-- 文件输出 -->
        <appender-ref ref="ERROR" />
        <appender-ref ref="INFO" />
        <appender-ref ref="WARN" />
        <appender-ref ref="DEBUG" />
        <appender-ref ref="TRACE" />
    </root>
</configuration>

4.配置文件节点详解

4.1 configuration节点相关属性

  1. debug：默认为false，要不要打印 logback内部日志信息，true则表示要打印。建议开启。
  2. scan：默认为true，配置发送改变时，要不要重新加载。
  3. scanPeriod：默认为 60 seconds，检测配置发生变化的时间间隔。如果没给出时间单位，默认时间单位是毫秒。

4.2 configuration子节点介绍

4.2.1. contextName节点

设置日志上下文名称，后面输出格式中可以通过定义 %contextName 来打印日志上下文名称

4.2.2. property节点

用来设置相关变量,通过key-value的方式配置，然后在后面的配置文件中通过 ${key}来访问。

4.2.3.appender 节点

日志输出组件，主要负责日志的输出以及格式化日志。常用的属性有name和class。

  1. name：无默认值，appender组件的名称，后面给logger指定appender使用

  2. class：无默认值，appender的具体实现类。常用的有 ConsoleAppender、FileAppender、RollingFileAppender。

ConsoleAppender：向控制台输出日志内容的组件，只要定义好encoder节点就可以使用。

FileAppender：向文件输出日志内容的组件，用法也很简单，不过由于没有日志滚动策略，一般很少使用。

RollingFileAppender：向文件输出日志内容的组件，同时可以配置日志文件滚动策略，在日志达到一定条件后生成一个新的日志文件。

appender节点中有一个子节点filter，配置具体的过滤器，比如上面的例子配置了一个内置的过滤器ThresholdFilter，然后设置了level的值为DEBUG。这样用这个appender输出日志的时候都会经过这个过滤器，日志级别低于DEBUG的都不会输出来。

在RollingFileAppender中，可以配置相关的滚动策略，具体可以看配置样例的注释。

4.2.4.logger以及root节点

root节点和logger节点其实都是表示Logger组件。root是最顶层的logger，正常情况getLogger(“name.class”)没有找到对应logger的情况下，都是使用root节点配置的logger。

如果配置了logger，并且通过getLogger(“name.class”)获取到这个logger，输出日志的时候，就会使用这个logger配置的appender输出，同时还会使用rootLogger配置的appender。我们可以使用logger节点的additivity="false"属性来屏蔽rootLogger的appender。这样就可以不使用rootLogger的appender输出日志了。

3.解析logback.xml配置文件入口
joeyhhhhh的博客
01-18 1074
前面介绍了slf4j相关的知识点,提到了实现模块是通过进行自定义日志框架的,本节就来介绍logback的默认的日志上下文是loggerContext使用spi获取到进行初始化,如果存在(默认不存在),并且执行后的返回值为则解析完成使用默认的进行初始化,其中比较核心,是logback用来解析logback.xml的配置类,解析成功后会返回,直接终端后面的配置类解析;默认的三个配置类如下可以通过环境参数。
日志输出 : SLF4J + LOGBACK
莫等闲的博客
11-27 404
日志输出 : SLF4J + LOGBACK java.util.logging、Commons Logging、Log4j、Log4j2、SLF4J、LOGBACK 都是JAVA生成日志的方式等，其中区别不做阐述，直接使用效率较高的 SLF4J + LOGBACK 组合来完成今天关于日志生成的复习。 SLF4J：提供统一的接口，使系统即使要将 Log4j 替换成 LOGBACK，也无需改变代码； LOGBACK：算是Log4j的升级版，是一个日志的实现。 参考资料：https://www.cnblogs.
Logback.xml 配置详解
热门推荐
My_wife_QBL的博客
07-12 1万+
为特定包或类定义 logger。</logger>定义全局的 root logger。</root>通过配置文件，我们可以灵活地控制日志的输出格式、日志级别、日志的输出目标等。Logback 提供了丰富的配置选项，包括控制台输出、文件输出、日志文件滚动、异步日志、日志过滤器等。合理配置日志，可以显著提高应用程序的可维护性和调试效率。希望本文能帮助你更好地理解和配置，为你的 Java 项目提供有力的日志支持。
logback-spring.xml配置解析
最新发布
qq_56536793的博客
05-22 1842
1. 从 Spring 上下文中读取配置（如 bootstrap.yml）使用 <springProperty> 可以从 Spring 配置文件中读取值，如：日志路径：logging.path日志级别：logging.level.root, logging.level.trade, logging.level.sign如果未在配置文件中指定，则使用 defaultValue 中的默认值。2. 自定义常量定义模块 ID 和名称，供后续日志文件名和格式中引用。1. 控制台输出：console。
logback logback.xml常用配置详解 <filter>
weixin_33881041的博客
12-18 161
　　&lt;filter&gt;: 　　过滤器，执行一个过滤器会有返回个枚举值，即DENY，NEUTRAL，ACCEPT其中之一。返回DENY，日志将立即被抛弃不再经过其他过滤器；返回NEUTRAL，有序列表里的下个过滤器过接着处理日志；返回ACCEPT，日志会被立即处理，不再经过剩余过滤器。 　　过滤器被添加到&lt;Appender&gt; 中，为&lt;Appender&gt; 添加一个或多...
logback.xml配置文件详解
Cavan_C的博客
03-08 1953
logback.xml常用配置详解 1、根节点<configuration>，包含三个属性 scan：当此属性设置为true时，配置文件如果发生改变，将会被重新加载，默认值为true； scanPeriod：设置监测配置文件是否有修改的时间间隔，如果没有给出时间单位，默认单位是毫秒。当scan为true时，此属性生效。默认的间隔时间为1分钟； debug：当此属性设置为true时，将打印出logback内部日志信息，实时查看logback运行状态。默认值为false。 示例： &
logback jar包和logback.xml配置文件打包下载 小白新手学Java
04-28
在这里，我们关注的是SLF4J的API库`slf4j-api-1.7.26.jar`，以及Logback的两个核心组件`logback-core-1.2.3.jar`和`logback-classic-1.2.3.jar`，以及配置文件`logback.xml`。 首先，`slf4j-api-1.7.26.jar`是SLF4J...
slf4j日志demo项目 logback.xml配置详解
02-11
slf4j日志demo项目 logback.xml配置详解,slf4j日志demo项目 logback.xml配置详解,slf4j日志demo项目 logback.xml配置详解,slf4j日志demo项目 logback.xml配置详解
logback的使用和logback.xml详解
04-26
**logback.xml配置文件详解** `logback.xml`配置文件是Logback的核心，它定义了日志记录的行为。以下是一些主要的配置元素： 1. ****: 配置文件的根元素。 2. ****: 定义日志器，可以按包名或类名设置日志级别。 ...
logback配置文件---logback.xml详解
weixin_30507269的博客
12-09 140
一、参考文档 1、官方文档 http://logback.qos.ch/documentation.html 2、博客文档 http://www.cnblogs.com/warking/p/5710303.html 二、logback.xml常用配置详解 常用节点结构图： 1、根节点<configuration>，包含下面三个属性： 　　　　scan: 当此属...
logback.xml配置以详解
qq_45559536的博客
03-30 617
记录一下项目中涉及到的日志配置信息： <?xml version="1.0" encoding="UTF-8"?> <!--scan为true：配置文件发生改变时，会重新加载。 scanPeriod：设置监测配置文件是否有修改的时间间隔 debug：为true时，将打印出logback内部日志信息，实时查看logback运行状态，默认值为false --> <configuration scan="true" scanPeriod="60 seconds" de
Logback配置详解——appender
微信公众号：一颗向上的草莓
05-18 2452
logback 常用配置详解（二）<appender> <appender>标签： <appender>是<configuration>的子节点，是负责写日志的组件。 <appender>有两个必要属性name和class。name指定appender名称，class指定appender的全限定名。 1.Console...
logback.xml配置（详解）
weixin_44779019的博客
07-28 3118
logback配置文件（无过滤器相关配置） ...
LogBack.xml配置文件详解
走下去
03-01 7989
&lt;?xml version="1.0" encoding="UTF-8"?&gt; &lt;!-- 日志级别 --&gt; &lt;!-- TRACE &lt; DEBUG &lt; INFO &lt; WARN &lt; ERROR --&gt; &lt;!-- 根节点&lt;configuration&gt;，包含下面三个属性： --&gt; &
logback.xml配置
qq_39020347的博客
08-19 226
- 这个会打印出所有的info及以下级别的信息，每次大小超过size，则这size大小的日志会自动存入按年份-月份建立的文件夹下面并进行压缩，作为存档 -->--日志级别以及优先级排序: OFF > FATAL > ERROR > WARN > INFO > DEBUG > TRACE > ALL -->--控制台只输出level及以上级别的信息（onMatch），其他的直接拒绝（onMismatch） -->-- status用来指定log4j本身的打印日志的级别 -->--输出日志的格式 -->...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值