（二） Log4j 配置详解

第一节： rootLogger 根配置

Log4j 根配置语法

 log4j.rootLogger = [ level ] , appenderName, appenderName, …

指代把指定级别的日志信息输出到指定的一个或者多个位置

其中，level 是日志记录的优先级，分为OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL或者自定义的级别。（具体详情见第二节log4j日志等级）

我们依然沿用前面的实例，

这里我们把INFO层级以及以上的信息输出到Console和File;

第二节： log4j 日志等级

Log4j根据日志信息的重要程度，分OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL

当然再细分的话还有 FATAL（严重错误），

如果配置OFF则不打出任何信息；如果配置为INFO这样只显示INFO、WARN、ERROR的log信息，而DEBUG信息不会被显示；如果配置为ALL则打印所有的日志。

但是Log4j官方建议实际实用的话，Log4j建议只使用四个级别，优先级从高到低分别是 ERROR、WARN、INFO、DEBUG

假如rootLogger定义的是DEBUG 那所有的报错信息都会输出；

我们沿用前面HelloWorld实例

假如定义的是INFO 那么DEBUG信息是不会输出的，其他信息输出；

假如定义最高等级ERROR，那么只有ERROR信息会输出，其他低等级信息是不会输出的；

第三节： log4j appender 输出类型配置

Log4j官方的appender给出了一下几种实现

org.apache.log4j.ConsoleAppender（控制台），

org.apache.log4j.FileAppender（文件），

org.apache.log4j.DailyRollingFileAppender（每天产生一个日志文件），

org.apache.log4j.RollingFileAppender（文件大小到达指定尺寸的时候产生一个新的文件），

org.apache.log4j.WriterAppender（将日志信息以流格式发送到任意指定的地方）

实际开发我们使用第1，第3和第4种实现；

假如日志数据量不是很大，我们可以用DailyRollingFileAppender 每天产生一个日志，方便查看；

假如日志数据量很大，我们一般用RollingFileAppender，固定尺寸的日志，假如超过了就产生一个新的文件；

我们这里给出一些实例；

 log4j.rootLogger=DEBUG, Console ,File ,DailyRollingFile ,RollingFile

 #Console

 log4j.appender.Console=org.apache.log4j.ConsoleAppender

 log4j.appender.Console.layout=org.apache.log4j.PatternLayout

 log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n

 #File

 log4j.appender.File = org.apache.log4j.FileAppender

 log4j.appender.File.File = D://log2.log

 log4j.appender.File.layout = org.apache.log4j.PatternLayout

 log4j.appender.File.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

 #DailyRollingFile

 log4j.appender.DailyRollingFile = org.apache.log4j.DailyRollingFileAppender

 log4j.appender.DailyRollingFile.File = D://log3.log

 log4j.appender.DailyRollingFile.layout = org.apache.log4j.PatternLayout

 log4j.appender.DailyRollingFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

 #RollingFile

 log4j.appender.RollingFile = org.apache.log4j.RollingFileAppender

 log4j.appender.RollingFile.File = D://log4.log

 log4j.appender.RollingFile.MaxFileSize=1KB

 log4j.appender.RollingFile.MaxBackupIndex=3

 log4j.appender.RollingFile.layout = org.apache.log4j.PatternLayout

 log4j.appender.RollingFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

测试代码：

 package com.wishwzp.log4j;

 import org.apache.log4j.Logger;

 /**

  * Log4j测试类

  * @author ainio

  *

  */

 public class Test {

     private static final Logger logger = Logger.getLogger(Test.class);    // 获取logger实例

     public static void main(String[] args) {

         logger.info("普通Info信息");

         logger.debug("调试debug信息");

         logger.error("报错error信息");

         logger.warn("警告warn信息");

         logger.fatal("严重错误fatal信息");

         logger.error("报错信息", new IllegalArgumentException("非法参数"));

         int i=0;

         while(i<10){

             logger.info("普通Info信息");

             logger.debug("调试debug信息");

             logger.error("报错error信息");

             logger.warn("警告warn信息");

             logger.fatal("严重错误fatal信息");

             logger.error("报错信息", new IllegalArgumentException("非法参数"));

             i++;

         }

     }

 }

这里有两个新的配置项解释下：

MaxFileSize 是日志文件的最大尺寸；根据实际需求来定 10KB 100KB也行

MaxBackupIndex是日志文件的个数，假如超过了，则覆盖，主要考虑到的是硬盘的容量问题；根据实际需求来定比如 100 500；

这里给下日志文件的效果：

整体效果：

DailyRollingFileAppender 效果：

RollingFileAppender 效果：

第四节： log4j layout 日志信息格式

Log4j提供的layout有以下几种

org.apache.log4j.HTMLLayout（以HTML表格形式布局），

org.apache.log4j.PatternLayout（可以灵活地指定布局模式），

org.apache.log4j.SimpleLayout（包含日志信息的级别和信息字符串），

org.apache.log4j.TTCCLayout（包含日志产生的时间、线程、类别等等信息）

HTMLLayout实例，我们把前面的实例的配置文件改下

 #Console

 log4j.appender.Console=org.apache.log4j.ConsoleAppender

 log4j.appender.Console.layout=org.apache.log4j.HTMLLayout

我们运行看下输出信息：

 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">

 <html>

 <head>

 <title>Log4J Log Messages</title>

 <style type="text/css">

 <!--

 body, table {font-family: arial,sans-serif; font-size: x-small;}

 th {background: #336699; color: #FFFFFF; text-align: left;}

 -->

 </style>

 </head>

 <body bgcolor="#FFFFFF" topmargin="6" leftmargin="6">

 <hr size="1" noshade>

 Log session start time Wed Mar 29 10:17:41 CST 2017<br>

 <br>

 <table cellspacing="0" cellpadding="4" border="1" bordercolor="#224466" width="100%">

 <tr>

 <th>Time</th>

 <th>Thread</th>

 <th>Level</th>

 <th>Category</th>

 <th>Message</th>

 </tr>

 <tr>

 <td>0</td>

 <td title="main thread">main</td>

 <td title="Level">INFO</td>

 <td title="com.wishwzp.Test category">com.open1111.Test</td>

 <td title="Message">普通Info信息</td>

 </tr>

 <tr>

 <td>16</td>

 <td title="main thread">main</td>

 <td title="Level"><font color="#339933">DEBUG</font></td>

 <td title="com.wishwzp.Test category">com.open1111.Test</td>

 <td title="Message">调试debug信息</td>

 </tr>

 <tr>

 <td>16</td>

 <td title="main thread">main</td>

 <td title="Level"><font color="#993300"><strong>ERROR</strong></font></td>

 <td title="com.wishwzp.Test category">com.open1111.Test</td>

 <td title="Message">报错error信息</td>

 </tr>

 <tr>

 <td>16</td>

 <td title="main thread">main</td>

 <td title="Level"><font color="#993300"><strong>WARN</strong></font></td>

 <td title="com.wishwzp.Test category">com.open1111.Test</td>

 <td title="Message">警告warn信息</td>

 </tr>

 <tr>

 <td>16</td>

 <td title="main thread">main</td>

 <td title="Level"><font color="#993300"><strong>FATAL</strong></font></td>

 <td title="com.wishwzp.Test category">com.open1111.Test</td>

 <td title="Message">严重错误fatal信息</td>

 </tr>

 <tr>

 <td>16</td>

 <td title="main thread">main</td>

 <td title="Level"><font color="#993300"><strong>ERROR</strong></font></td>

 <td title="com.wishwzp.Test category">com.open1111.Test</td>

 <td title="Message">报错信息</td>

 </tr>

 <tr><td bgcolor="#993300" style="color:White; font-size : xx-small;" colspan="6">java.lang.IllegalArgumentException: 非法参数

 <br>&nbsp;&nbsp;&nbsp;&nbsp;  at com.wishwzp.Test.main(Test.java:16)

 </td></tr>

标准的html table表格格式，显示信息包括线程等级类报错信息；

PatternLayout是我们以后推荐使用的，很灵活；

有个ConversionPattern属性，灵活配置输出属性：

%m 输出代码中指定的消息；

%M 输出打印该条日志的方法名；

%p 输出优先级，即DEBUG，INFO，WARN，ERROR，FATAL；

%r 输出自应用启动到输出该log信息耗费的毫秒数；

%c 输出所属的类目，通常就是所在类的全名；

%t 输出产生该日志事件的线程名；

%n 输出一个回车换行符，Windows平台为"rn”，Unix平台为"n”；

%d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式，比如：%d{yyyy-MM-dd HH:mm:ss,SSS}，输出类似：2002-10-18 22:10:28,921；

%l 输出日志事件的发生位置，及在代码中的行数；

SimpleLayout简单布局：

 #Console

 log4j.appender.Console=org.apache.log4j.ConsoleAppender

 log4j.appender.Console.layout=org.apache.log4j.SimpleLayout

运行输出：

INFO - 普通Info信息

DEBUG - 调试debug信息

ERROR - 报错error信息

WARN - 警告warn信息

FATAL - 严重错误fatal信息

ERROR - 报错信息

java.lang.IllegalArgumentException: 非法参数

at com.wishwzp.Test.main(Test.java:16)

只有级别和信息，确实简单

TTCCLayout我们测试下：

 #Console

 log4j.appender.Console=org.apache.log4j.ConsoleAppender

 log4j.appender.Console.layout=org.apache.log4j.TTCCLayout

运行输出：

[main] INFO com.wishwzp.Test - 普通Info信息

[main] DEBUG com.wishwzp.Test - 调试debug信息

[main] ERROR com.wishwzp.Test - 报错error信息

[main] WARN com.wishwzp.Test - 警告warn信息

[main] FATAL com.wishwzp.Test - 严重错误fatal信息

[main] ERROR com.wishwzp.Test - 报错信息

java.lang.IllegalArgumentException: 非法参数

at com.wishwzp.Test.main(Test.java:16)

我们实际开发使用的是灵活的PatternLayout 其他的了解即可；

第五节： Log4j Threshold 属性指定输出等级

有时候我们需要把一些报错ERROR日志单独存到指定文件，这时候，Threshold属性就派上用场了；

Threshold属性可以指定日志level

Log4j根据日志信息的重要程度，分OFF、FATAL、ERROR、WARN、INFO、DEBUG、ALL

比如我们指定某个appender的Threshold为WARN，那这个appender输出的日志信息就是WARN级别以及WARN以上的级别；

假如我们指定的是ERROR，那这个就输出ERROR或者FATAL日志信息；

当然这里有个提前 rootLogger里配置的level比如小于Threshold层级否则无效还是按照总的rootLogger里的level来输出，一般我们实际实用的话 rootLogger里配置DEBUG，然后某个文件专门存储ERRO日志，就配置下Threshold为ERROR，这个就是我们的最佳实践，不要乱七八糟瞎配置；

我们给下参考配置：

log4j.rootLogger=DEBUG, Console ,DFile ,EFILE

#Console

log4j.appender.Console=org.apache.log4j.ConsoleAppender

log4j.appender.Console.layout=org.apache.log4j.TTCCLayout

#DEBUGFile

log4j.appender.DFile = org.apache.log4j.FileAppender

log4j.appender.DFile.File = C://DEBUG.log

log4j.appender.DFile.layout = org.apache.log4j.PatternLayout

log4j.appender.DFile.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

log4j.appender.DFile.Threshold = DEBUG

#ERRORFile

log4j.appender.EFILE = org.apache.log4j.FileAppender

log4j.appender.EFILE.File = C://ERROR.log

log4j.appender.EFILE.layout = org.apache.log4j.PatternLayout

log4j.appender.EFILE.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

log4j.appender.EFILE.Threshold = ERROR

rootLogger里配置DEBUG，

DFile的Threshold 配置为DEBUG

EFILE的Threshold 配置为ERROR 只输入ERROR信息；

控制台输出：

DEBUG.log文件：

ERROR.log文件

ERROR.LOG只输出error信息；

第六节： Log4j Append 属性指定是否追加内容

Log4j默认是不断的把日志内容追加到日志文件；

这里就有个属性 Append 默认就是true；

假如我们设置成false 就不追加了直接覆盖前面的内容；

我们来测试下：

log4j.rootLogger=DEBUG, Console ,FIEL

#Console

log4j.appender.Console=org.apache.log4j.ConsoleAppender

log4j.appender.Console.layout=org.apache.log4j.TTCCLayout

#FIEL

log4j.appender.FIEL = org.apache.log4j.FileAppender

log4j.appender.FIEL.File = C://log.log

log4j.appender.FIEL.layout = org.apache.log4j.PatternLayout

log4j.appender.FIEL.layout.ConversionPattern =%d [%t] %-5p [%c] - %m%n

log4j.appender.FIEL.Append = false

改成了 Append 为 false

测试类：

 package com.wishwzp.log4j;

 import org.apache.log4j.Logger;

 /**

  * Log4j测试类

  * @author ainio

  *

  */

 public class Test {

     private static final Logger logger = Logger.getLogger(Test.class);    // 获取logger实例

     public static void main(String[] args) {

         logger.info("普通Info信息");

         logger.debug("调试debug信息");

         logger.error("报错error信息");

         logger.warn("警告warn信息");

         logger.fatal("严重错误fatal信息");

         logger.error("报错信息", new IllegalArgumentException("非法参数"));

     }

 }

我们第一次执行：

我们修改下测试代码：

 package com.wishwzp.log4j;

 import org.apache.log4j.Logger;

 /**

  * Log4j测试类

  * @author ainio

  *

  */

 public class Test {

     private static final Logger logger = Logger.getLogger(Test.class);    // 获取logger实例

     public static void main(String[] args) {

         logger.info("普通Info信息222222222222");

         logger.debug("调试debug信息");

         logger.error("报错error信息22222222222");

         logger.warn("警告warn信息");

         logger.fatal("严重错误fatal信息");

         logger.error("报错信息222222222222", new IllegalArgumentException("非法参数"));

     }

 }

按照默认 Append为 true

是追加的，我们这里Append 为false

结果是覆盖前面的

OK 这个属性我们了解下即可用默认的true即可；

（二） Log4j 配置详解

第一节： rootLogger 根配置

第二节： log4j 日志等级

第三节： log4j appender 输出类型配置

第四节： log4j layout 日志信息格式

第五节： Log4j Threshold 属性指定输出等级

第六节： Log4j Append 属性指定是否追加内容

（二） Log4j 配置详解的相关教程结束。

相关推荐

Eclipse配置python开发环境过程图解

spring-mvc 系列：注解开发（SpringMVCConfig、SpringConfig、AbstractAnnotationConfigDispatcherServletInitializer详细配置）

Log4j的Maven依赖及其配置文件

Maven资源导出问题所需配置

Mybatis开发中的常用Maven配置

Proxmox VE软件防火墙的配置

rnacos——用rust重新实现的nacos开源配置、注册中心服务

从案例中详解go-errgroup-源码