Log4j2的xml配置文件如何编写 详解Appenders和Loggers的配置

煙雲
发布: 2025-11-19 20:03:05
原创
201人浏览过
Log4j2的XML配置通过Appenders定义日志输出目标,Loggers控制日志级别与处理行为,结合使用可实现灵活的日志管理。

log4j2的xml配置文件如何编写 详解appenders和loggers的配置

Log4j2 的 XML 配置文件是控制日志输出格式、目标和级别的重要方式。通过合理配置 AppendersLoggers,可以灵活管理应用程序的日志行为。下面详细介绍如何编写 Log4j2 的 XML 配置文件,并说明 Appenders 与 Loggers 的作用及配置方法。

配置文件基本结构

Log4j2 的 XML 配置文件通常命名为 log4j2.xml,放置在项目的 classpath 下(如 src/main/resources)。其根元素为 Configuration,常用属性包括 status(用于输出内部日志信息)和 monitorInterval(自动重载配置的时间间隔,单位秒)。

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" monitorInterval="30">
  <Appenders>
    ...
  </Appenders>
  <Loggers>
    ...
  </Loggers>
</Configuration>

status="WARN" 表示只输出 Log4j2 自身的警告及以上级别的内部日志,避免干扰应用日志。monitorInterval="30" 表示每 30 秒检查一次配置文件是否变更,若有则自动重新加载。

Appenders 配置:定义日志输出目的地

Appenders 决定日志输出到哪里,比如控制台、文件、数据库或远程服务。常见的 Appender 类型有 Console、File、RollingFile 等。

1. ConsoleAppender:输出到控制台

<Console name="Console" target="SYSTEM_OUT">
  <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
</Console>
  • name:Appender 的唯一标识名
  • target:可选 SYSTEM_OUT 或 SYSTEM_ERR
  • PatternLayout:定义日志输出格式

2. FileAppender:输出到固定文件

<File name="FileAppender" fileName="logs/app.log">
  <PatternLayout pattern="%d %p %c{1.} %m%n"/>
</File>
  • fileName:指定日志文件路径
  • 日志会一直追加到该文件,不会自动滚动

3. RollingFileAppender:按条件滚动日志文件

<RollingFile name="RollingFile" fileName="logs/app.log"
    filePattern="logs/app-%d{yyyy-MM-dd}-%i.log.gz">
  <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} %msg%n"/>
  <Policies>
    <TimeBasedTriggeringPolicy interval="1"/>
    <SizeBasedTriggeringPolicy size="10MB"/>
  </Policies>
  <DefaultRolloverStrategy max="20"/>
</RollingFile>
  • filePattern:定义归档文件命名规则,支持日期和序号
  • Policies:触发滚动的策略,如按时间或大小
  • DefaultRolloverStrategy max="20":最多保留 20 个归档文件

Loggers 配置:控制日志记录行为

Loggers 负责接收日志事件,并决定是否处理以及使用哪些 Appenders 输出。分为根 Logger(Root Logger)和自定义 Logger。

绘蛙AI修图
绘蛙AI修图

绘蛙平台AI修图工具,支持手脚修复、商品重绘、AI扩图、AI换色

绘蛙AI修图 264
查看详情 绘蛙AI修图

1. Root Logger:默认日志处理器

<Root level="info">
  <AppenderRef ref="Console"/>
  <AppenderRef ref="RollingFile"/>
</Root>
  • level:设置日志级别,常见值有 trace、debug、info、warn、error
  • AppenderRef:引用已定义的 Appender 名称

所有未单独配置的类都会使用 Root Logger 的设置。

2. 自定义 Logger:针对特定包或类

<Logger name="com.example.service" level="debug" additivity="false">
  <AppenderRef ref="RollingFile"/>
</Logger>
  • name:通常是 Java 包名或类名
  • level:此 Logger 的日志级别
  • additivity="false":表示不继承 Root Logger 的 Appenders,避免重复输出

例如,将 service 包下的日志设为 debug 级别,并只输出到文件,而其他包仍使用 root 的配置。

完整配置示例

<?xml version="1.0" encoding="UTF-8"?>
<Configuration status="WARN" monitorInterval="30">
  <Appenders>
    <Console name="Console" target="SYSTEM_OUT">
      <PatternLayout pattern="%d{HH:mm:ss.SSS} [%t] %-5level %logger{36} - %msg%n"/>
    </Console>
    <RollingFile name="RollingFile" fileName="logs/app.log"
      filePattern="logs/app-%d{yyyy-MM-dd}-%i.log.gz">
      <PatternLayout pattern="%d{yyyy-MM-dd HH:mm:ss} %-5level %logger{36} %msg%n"/>
      <Policies>
        <TimeBasedTriggeringPolicy interval="1"/>
        <SizeBasedTriggeringPolicy size="10MB"/>
      </Policies>
      <DefaultRolloverStrategy max="20"/>
    </RollingFile>
  </Appenders>
  <Loggers>
    <Logger name="com.example.dao" level="debug" additivity="false">
      <AppenderRef ref="RollingFile"/>
    </Logger>
    <Root level="info">
      <AppenderRef ref="Console"/>
      <AppenderRef ref="RollingFile"/>
    </Root>
  </Loggers>
</Configuration>

这个配置实现了:

  • 控制台输出 info 及以上日志
  • 所有日志写入滚动文件
  • dao 包下 debug 日志也记录到文件,且不重复输出到控制台
  • 每天或文件超过 10MB 时自动归档,最多保留 20 个备份

基本上就这些。理解 Appenders 和 Loggers 的分工与协作,就能写出满足大多数场景的日志配置。

以上就是Log4j2的xml配置文件如何编写 详解Appenders和Loggers的配置的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号