Log4j教程

log4j是一个用Java编写的可靠，快速和灵活的日志框架（API），它在Apache软件许可下发布。 Log4j已经被移植到了C，C++，C＃，Perl，Python和Ruby等语言中。Log4j是高度可配置的，并可通过在运行时的外部文件配置。它根据记录的优先级别，并提供机制，以指示记录信息到许多的目的地，诸如：数据库，文件，控制台，UNIX系统日志等。

Log4j中有三个主要组成部分：

• loggers: 负责捕获记录信息。
• appenders : 负责发布日志信息，以不同的首选目的地。
• layouts: 负责格式化不同风格的日志信息。

log4j的历史

• 始于1996年初的E.U. SEMPER （安全电子市场为欧洲）跟踪API的项目。
• 不计其数的改进，在几个大量的工作之后，API已经发展成为log4j，一个流行的日志记录包为Java。
• 该软件包是Apache软件许可证，由开源认证是一个不折不扣的开源许可证下发布。
• 最新log4j的版本，包括完整的源代码，类文件和文档可以在这里找到 http://logging.apache.org/log4j/.

log4j 特性:

• log4j的是线程安全的
• log4j是经过优化速度的
• log4j是基于一个名为记录器的层次结构
• log4j的支持每个记录器多输出追加器（appender）
• log4j支持国际化。
• log4j并不限于一组预定义的设备
• 日志行为可以使用配置文件在运行时设置
• log4j设计从一开始就是处理Java异常
• log4j使用多个层次，即ALL，TRACE，DEBUG，INFO，WARN，ERROR和FATAL
• 日志输出的格式可以通过扩展Layout类容易地改变
• 日志输出的目标，以及在写入策略可通过实现Appender程序接口改变
• log4j 会故障停止。然而，尽管它肯定努力确保传递，log4j不保证每个日志语句将被传递到目的地。

日志记录N个缺点及优点：

日志是软件开发的重要组成部分。一个精心编写的日志代码提供快速的调试，维护方便，以及应用程序的运行时信息结构化存储。

日志记录确实也有它的缺点。它可以减缓的应用程序。如果太详细，它可能会导致滚动失明。为了减轻这些影响，log4j被设计为是可靠，快速和可扩展。

由于记录很少为应用的主要重点，但log4j API致力于成为易于理解和使用。

log4j安装配置 - Log4j教程

Log4j的API包使用Apache软件许可证，由开源倡议认证一个完全成熟的开源许可证下发布。

最新log4j的版本，包括完整的源代码，类文件和文档可以在这里找到 http://logging.apache.org/log4j/.

下载 apache-log4j-x.x.x.tar.gz 做到以下几点：

步骤1:

将下载的文件解压缩和解压在 /usr/local/ 目录，如下所示：

$ gunzip apache-log4j-1.2.15.tar.gz
$ tar -xvf apache-log4j-1.2.15.tar
apache-log4j-1.2.15/tests/input/
apache-log4j-1.2.15/tests/input/xml/
apache-log4j-1.2.15/tests/src/
apache-log4j-1.2.15/tests/src/java/
apache-log4j-1.2.15/tests/src/java/org/
.......................................

当执行解压缩，这将创建一个名称 apache-log4j-x.x.x 的目录层次结构如下：

-rw-r--r-- 1 root root 3565 2007-08-25 00:09 BUILD-INFO.txt
-rw-r--r-- 1 root root 2607 2007-08-25 00:09 build.properties.sample
-rw-r--r-- 1 root root 32619 2007-08-25 00:09 build.xml
drwxr-xr-x 14 root root 4096 2010-02-04 14:09 contribs
drwxr-xr-x 5 root root 4096 2010-02-04 14:09 examples
-rw-r--r-- 1 root root 2752 2007-08-25 00:09 INSTALL
-rw-r--r-- 1 root root 4787 2007-08-25 00:09 KEYS
-rw-r--r-- 1 root root 11366 2007-08-25 00:09 LICENSE
-rw-r--r-- 1 root root 391834 2007-08-25 00:29 log4j-1.2.15.jar
-rw-r--r-- 1 root root 160 2007-08-25 00:09 NOTICE
-rwxr-xr-x 1 root root 10240 2007-08-25 00:27 NTEventLogAppender.dll
-rw-r--r-- 1 root root 17780 2007-08-25 00:09 pom.xml
drwxr-xr-x 7 root root 4096 2007-08-25 00:13 site
drwxr-xr-x 8 root root 4096 2010-02-04 14:08 src
drwxr-xr-x 6 root root 4096 2010-02-04 14:09 tests

步骤2:

这一步是可选的，取决于什么功能，要使用log4j 框架。如果已经有以下安装在您的机器，那么可以使用这些软件包，否则将需要安装它们，才能正常使log4j工作

• JavaMail API: 电子邮件。基于log4j日志记录功能需要Java邮件API（mail.jar）在计算机上安装 https://glassfish.dev.java.net/javaee5/mail/
• JavaBeans 活动框架： Java邮件API还需要JavaBeans激活框架（的activation.jar）从http://java.sun.com/products/javabeans/jaf/index.jsp 上下载安装在您的计算机上
• Java 信息服务: log4j的JMS兼容的功能将需要两个JMS和JNDI（Java命名和Directory接口），可以从http://java.sun.com/products/jms 下载安装
• XML Parser: 需要一个JAXP兼容的XML解析器来使用log4j。请确保已经在机器上安装xerces.jar ，可从http://xerces.apache.org/xerces-j/install.html 下载安装

步骤3:

这一步是非常重要的，需要设置CLASSPATH和PATH变量正确。在这里要设置只是 log4j.x.x.x.jar 文件

$ pwd
/usr/local/apache-log4j-1.2.15
$ export CLASSPATH=
$CLASSPATH:/usr/local/apache-log4j-1.2.15/log4j-1.2.15.jar
$ export PATH=$PATH:/usr/local/apache-log4j-1.2.15/

注意：如果在Window上开发使用Eclipse的话，可以在Eclipse创建用户库并加入到构建路径中。

log4j架构 - Log4j教程

Log4j API设计为分层结构，其中每一层提供了不同的对象，对象执行不同的任务。这使得设计灵活，根据将来需要来扩展。

有两种类型可用在Log4j的框架对象。

• 核心对象： 框架的强制对象和框架的使用。
• 支持对象： 框架和支持体核心对象，可选的对象执行另外重要的任务。

核心对象：

Logger对象：

顶级层的Logger，它提供Logger对象。Logger对象负责捕获日志信息及它们存储在一个空间的层次结构。

布局对象：

该层提供其用于格式化不同风格的日志信息的对象。布局层提供支持Appender对象到发布日志信息之前。

布局对象的发布方式是人类可读的及可重复使用的记录信息的一个重要的角色。

Appender对象：

下位层提供Appender对象。Appender对象负责发布日志信息，以不同的首选目的地，如数据库，文件，控制台，UNIX系统日志等。

以下是显示Log4J框架的不同组件的虚拟图：

支持对象：

log4j框架的其他重要的对象起到日志框架的一个重要作用：

Level对象：

级别对象定义的任何记录信息的粒度和优先级。有记录的七个级别在API中定义：OFF, DEBUG, INFO, ERROR, WARN, FATAL 和 ALL

Filter对象：

过滤对象用于分析日志信息及是否应记录或不用这些信息做出进一步的决定。

一个appender对象可以有与之关联的几个Filter对象。如果日志记录信息传递给特定Appender对象，都和特定Appender相关的Filter对象批准的日志信息，然后才能发布到所连接的目的地。

对象渲染器：

ObjectRenderer对象是一个指定提供传递到日志框架的不同对象的字符串表示。这个对象所使用的布局对象来准备最后的日志信息。

日志管理：

日志管理对象管理的日志框架。它负责从一个系统级的配置文件或配置类读取初始配置参数。

log4j配置 - Log4j教程

上一章介绍log4j的核心组件。本章介绍如何使用配置文件来配置这些核心组件。配置log4j涉及分配级别，定义追加程序，并在配置文件中指定布局的对象。

log4j.properties文件是一个键 - 值对保存 log4j 配置属性文件。默认情况下，日志管理在CLASSPATH 查找一个名为 log4j.properties 的文件。

• 根日志记录器的级别定义为DEBUG并连接附加器命名为X到它
• 设置名为X的附加目的地是一个有效的appender
• 设置布局的附加器X

log4j.properties 语法:

以下是 log4j.properties 文件的一个appender X的语法：

# Define the root logger with appender X
log4j.rootLogger = DEBUG, X

# Set the appender named X to be a File appender
log4j.appender.X=org.apache.log4j.FileAppender

# Define the layout for X appender
log4j.appender.X.layout=org.apache.log4j.PatternLayout
log4j.appender.X.layout.conversionPattern=%m%n

log4j.properties 示例:

使用上面的语法，我们定义 log4j.properties 文件如下：

• 根日志记录器(logger)的级别定义为DEBUG并连接附加器命名为FILE
• 附加器(appender)File是定义为org.apache.log4j.FileAppender并写入到一个名为“log.out”位于日志log目录下
• 定义的布局模式是%m%n，这意味着每打印日志消息之后，将加上一个换行符

# Define the root logger with appender file
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/log.out

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n

需要注意的是log4j支持UNIX风格的变量替换，如 ${variableName}.

调试级别：

使用DEBUG两个追加程序。所有可能的选项有：

• TRACE
• DEBUG
• INFO
• WARN
• ERROR
• FATAL
• ALL

这些级别将在 Log4j调试级别 这一文章中解释

Appenders:

Apache的log4j提供Appender对象主要负责打印日志消息到不同的目的地，如控制台，文件，sockets，NT事件日志等等。

每个Appender对象具有与之相关联的不同的属性，并且这些属性表明对象的行为

可以通过包括以下方法的配置文件中的下面设置一个 Appender 对象添加到记录器：

log4j.logger.[logger-name]=level, appender1,appender..n

可以编写以XML格式相同的结构如下：

<logger name="com.apress.logging.log4j" additivity="false">
<appender-ref ref="appender1"/>
<appender-ref ref="appender2"/>
</logger>

如果想要添加Appender对象到程序，那么可以使用下面的方法：

public void addAppender(Appender appender);

addAppender()方法添加一个appender到Logger对象。作为示例配置演示，可以添加很多Appender对象到记录器在逗号分隔的列表，每个打印日志信息分离目的地。

我们仅使用一个附加目的地FileAppender在我们上面的例子。所有可能的附加目的地选项有：

• AppenderSkeleton
• AsyncAppender
• ConsoleAppender
• DailyRollingFileAppender
• ExternallyRolledFileAppender
• FileAppender
• JDBCAppender
• JMSAppender
• LF5Appender
• NTEventLogAppender
• NullAppender
• RollingFileAppender
• SMTPAppender
• SocketAppender
• SocketHubAppender
• SyslogAppender
• TelnetAppender
• WriterAppender

我们将涵盖 FileAppender文件 和 JDBCAppender 记录将被包括记录在数据库

Layout:

我们使用的PatternLayout 使用 appender。所有可能的选项有：

• DateLayout
• HTMLLayout
• PatternLayout
• SimpleLayout
• XMLLayout

使用HTMLLayout和XMLLayout，可以在HTML和XML格式和生成日志。

布局格式：

如何在章节格式的日志信息：Log格式

log4j示例程序 - Log4j教程

前面我们已经看到了如何创建一个配置文件。本教程将讲解如何生成调试信息和日志在一个简单的文本文件。

下面是我们的例子中创建了一个简单的配置文件。这里再重复一次：

• 下载最新的Log4j库：http://logging.apache.org/log4j/2.x/download.html
• 根记录器的级别定义为DEBUG并连接appender命名为FILE。
• appender FILE文件被定义为 org.apache.log4j.FileAppender 并写入到一个名为“log.out”位于 log 目录下。
• 定义的布局模式是 %m%n，这意味着打印日志消息之后自动加上一个换行符。

所以 log4j.properties 文件的内容如下：

# Define the root logger with appender file
log = /usr/home/log4j
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/log.out

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n

在Java程序中使用log4j：

下面的Java类是一个非常简单的例子，Java应用程序初始化，然后使用Log4J日志库。

import org.apache.log4j.Logger;

import java.io.*;
import java.sql.SQLException;
import java.util.*;

public class log4jExample{
/* Get actual class name to be printed on */
static Logger log = Logger.getLogger(
log4jExample.class.getName());

public static void main(String[] args)
throws IOException,SQLException{

log.debug("Hello this is an debug message");
log.info("Hello this is an info message");
}
}

编译和运行：

下面是步骤编译并运行上述程序。确保在进行编译和执行之前，适当地设置PATH和CLASSPATH。

所有的库应该在 CLASSPATH 和 log4j.properties 文件应该在PATH可用。所以，做到以下几点：

• 创建log4j.properties如上图所示。
• 创建log4jExample.java如上图所示，并对其进行编译。
• 执行log4jExample二进制运行程序。

在里面 /usr/home/log4j/log.out 文件会得到下面的结果：

Hello this is an debug message
Hello this is an info message

log4j Logger方法 - Log4j教程

Logger类提供了多种方法来处理日志活动。 Logger类不允许实例化一个新的记录器实例，但它提供了两个静态方法获得一个 Logger 对象：

• public static Logger getRootLogger();
• public static Logger getLogger(String name);

此处两种方法的第一个返回应用程序实例根记录器并没有名字。任何其他命名的Logger对象实例是通过第二种方法通过记录器的名称获得。记录器名称是可以传递任何字符串，通常是类或包的名称，因为我们已经使用在最后一章。

static Logger log = Logger.getLogger(log4jExample.class.getName());

Logging 方法:

我们得到了一个名为记录器的实例之后，可以使用记录的几种方法来记录消息。 Logger类有专门用于打印日志信息下面的方法如下。

所有的级别定义在org.apache.log4j.Level类中，并且任何上述方法都可以调用如下：

import org.apache.log4j.Logger;

public class LogClass {
private static org.apache.log4j.Logger log = Logger
.getLogger(LogClass.class);
public static void main(String[] args) {
log.trace("Trace Message!");
log.debug("Debug Message!");
log.info("Info Message!");
log.warn("Warn Message!");
log.error("Error Message!");
log.fatal("Fatal Message!");
}
}

当编译并运行LogClass程序会产生以下结果：

Debug Message!
Info Message!
Warn Message!
Error Message!
Fatal Message!

所有的调试消息更有意义，当它们在级别组合使用。级别将在下一章介绍，那么在下一节会有一个很好的理解及如何使用这些方法在不同的级别调试。

log4j日志记录级别 - Log4j教程

org.apache.log4j.Level类提供以下级别，但也可以通过Level类的子类自定义级别。

日志级别是如何工作？

级别p的级别使用q，在记录日志请求时，如果p>=q启用。这条规则是log4j的核心。它假设级别是有序的。对于标准级别它们关系如下：ALL < DEBUG < INFO < WARN < ERROR < FATAL < OFF。

下面的例子明确指出如何可以过滤所有的DEBUG和INFO消息。这个程序使用记录并执行setLevel（Level.X）方法来设置所需的日志记录级别：

这个例子将打印，除了调试和信息的所有消息：

import org.apache.log4j.*;

public class LogClass {
private static org.apache.log4j.Logger log = Logger
.getLogger(LogClass.class);
public static void main(String[] args) {
log.setLevel(Level.WARN);

log.trace("Trace Message!");
log.debug("Debug Message!");
log.info("Info Message!");
log.warn("Warn Message!");
log.error("Error Message!");
log.fatal("Fatal Message!");
}
}

当编译并运行LogClass程序会产生以下结果：

Warn Message!
Error Message!
Fatal Message!

使用配置文件设置级别：

Log4j提供这些可以让程序员自由更改源代码，改变调试级别的配置级别是基于文件设置。

以下是上面的例子使用 log.setLevel（Level.WARN）方法的配置文件与上面的例子例子功能一样。

# Define the root logger with appender file
log = /usr/home/log4j
log4j.rootLogger = WARN, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/log.out

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n

现在，使用下面的程序：

import org.apache.log4j.*;

public class LogClass {
private static org.apache.log4j.Logger log = Logger
.getLogger(LogClass.class);
public static void main(String[] args) {
log.trace("Trace Message!");
log.debug("Debug Message!");
log.info("Info Message!");
log.warn("Warn Message!");
log.error("Error Message!");
log.fatal("Fatal Message!");
}
}

现在，编译和运行上面的程序，得到以下结果在 /usr/home/log4j/log.out 文件：

Warn Message!
Error Message!
Fatal Message!

log4j日志格式化 - Log4j教程

Apache log4j 提供了各种布局对象，每一个对象都可以根据各种布局格式记录数据。另外，也可以创建一个布局对象格式化测井数据中的特定应用的方法。

所有的布局对象 - Appender对象收到 LoggingEvent 对象。布局对象检索来自LoggingEvent 的消息参数，并应用适当的 ObjectRenderer 获得消息的字符串表示。

布局类型：

在层次结构中的顶级类是抽象类是org.apache.log4j.Layout。这是 log4j 的 API 中的所有其他布局类的基类。

布局类定义为抽象在应用程序中，不要直接使用这个类; 相反，使用它的子类来工作，如下：

• DateLayout
• HTMLLayout ( 在本教程解释)
• PatternLayout ( 在本教程解释)
• SimpleLayout
• XMLLayout

布局方法：

这个类提供了一个框架实现在所有其它布局对象的所有常见的操作，并声明了两个抽象方法。

除了这些抽象方法，布局类提供具体的实现下列方法：

每个子类可以通过重写的具体实现这些方法返回类特定的信息。

log4j HTMLLayout - Log4j教程

如果想生成一个HTML格式的文件，日志信息，那么可以使用 org.apache.log4j.HTMLLayout 格式化日志信息。

HTMLLayout类扩展抽象org.apache.log4j.Layout类，并覆盖其基类的 format()方法来提供HTML样式格式。

这提供了以下信息显示：

• 生成特定的日志事件之前，从应用程序的开始所经过的时间
• 调用该记录请求的线程的名称
• 与此记录请求相关联的级别
• 日志记录器(Logger)和记录消息的名称
• 可选程序文件的位置信息，并从其中记录被调用的行号

HTMLLayout是一个非常简单的布局对象，它提供以下方法：

HTMLLayout 例子：

以下是对HTMLLayout一个简单的配置文件：

# Define the root logger with appender file
log = /usr/home/log4j
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/htmlLayout.html

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.HTMLLayout
log4j.appender.FILE.layout.Title=HTML Layout Example
log4j.appender.FILE.layout.LocationInfo=true

现在考虑下面的Java例子用于产生日志信息：

import org.apache.log4j.Logger;

import java.io.*;
import java.sql.SQLException;
import java.util.*;

public class log4jExample{
/* Get actual class name to be printed on */
static Logger log = Logger.getLogger(
log4jExample.class.getName());

public static void main(String[] args)
throws IOException,SQLException{

log.debug("Hello this is an debug message");
log.info("Hello this is an info message");
}
}

编译并运行上述程序，它会在 /usr/home/log4j 目录创建 htmlLayout.html 文件，该文件将有如下的日志信息：

Log session start time Mon Mar 22 13:30:24 AST 2014

可以使用一个Web浏览器打开htmlLayout.html 文件。同样重要的是要注意，页脚</ HTML>和</ body>标记是完全缺失。

一个具有HTML格式的日志文件的一大优势是，它可以被发布为网页可以远程查看。

log4j PatternLayout - Log4j教程

如果想生成基于模式的特定格式的日志信息，那么可以使用 org.apache.log4j.PatternLayout 格式化日志信息。

PatternLayout类扩展抽象 org.apache.log4j.Layout 类并覆盖format()方法根据提供的模式构建日志信息。

PatternLayout也是一个简单的布局对象，它提供下列Bean属性，可以通过配置文件进行设置：

模式转换字符：

下表说明了以上模式使用的字符和所有其他字符，可以在自定义模式中使用：

格式修饰符：

默认情况下，相关资料原样输出。然而，随着格式修饰符的帮助下，可以改变最小字段宽度，最大字段宽度和对齐。

下表涵盖了各种各样的修饰符的情况：

PatternLayout 示例:

以下是针对 PatternLayout 一个简单的配置文件：

# Define the root logger with appender file
log = /usr/home/log4j
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
log4j.appender.FILE.File=${log}/log.out

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.ConversionPattern=
%d{yyyy-MM-dd}-%t-%x-%-5p-%-10c:%m%n

现在考虑下面产生日志信息的Java例子：

import org.apache.log4j.Logger;

import java.io.*;
import java.sql.SQLException;
import java.util.*;

public class log4jExample{
/* Get actual class name to be printed on */
static Logger log = Logger.getLogger(
log4jExample.class.getName());

public static void main(String[] args)
throws IOException,SQLException{

log.debug("Hello this is an debug message");
log.info("Hello this is an info message");
}
}

编译并运行上述程序，它会创建 log.out文件在 /usr/home/log4j 目录，该文件将有如下的日志信息：

2010-03-23-main--DEBUG-log4jExample:Hello this is an debug message
2010-03-23-main--INFO -log4jExample:Hello this is an info message

log4j日志记录到文件 - Log4j教程

要写日志信息到一个文件中，必须使用org.apache.log4j.FileAppender。有以下FileAppender的配置参数：

FileAppender配置：

下面是一个示例配置文件 log4j.properties 的 FileAppender。

# Define the root logger with appender file
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.FileAppender
# Set the name of the file
log4j.appender.FILE.File=${log}/log.out

# Set the immediate flush to true (default)
log4j.appender.FILE.ImmediateFlush=true

# Set the threshold to debug mode
log4j.appender.FILE.Threshold=debug

# Set the append to false, overwrite
log4j.appender.FILE.Append=false

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n

如果喜欢相当于上述log4j.properties文件的XML配置文件，在这里是xml配置文件的内容：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration>

<appender name="FILE" class="org.apache.log4j.FileAppender">
<param name="file" value="${log}/log.out"/>
<param name="immediateFlush" value="true"/>
<param name="threshold" value="debug"/>
<param name="append" value="false"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="conversionPattern" value="%m%n"/>
</layout>
</appender>

<logger name="log4j.rootLogger" additivity="false">
<level value="DEBUG"/>
<appender-ref ref="FILE"/>
</logger>

</log4j:configuration>

可以尝试在 log4j - 示例程序 使用上面的配置。

日志记录到多个文件：

当想要写日志信息转化多个文件要求一样，例如，如果文件大小达到一定的阈值等。

写日志记录信息分成多个文件，必须扩展FileAppender类，并继承其所有属性useorg.apache.log4j.RollingFileAppender类。

有以下除了已如上所述为 FileAppender 可配置参数：

下面是一个示例配置文件log4j.properties的RollingFileAppender进行

# Define the root logger with appender file
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.RollingFileAppender
# Set the name of the file
log4j.appender.FILE.File=${log}/log.out

# Set the immediate flush to true (default)
log4j.appender.FILE.ImmediateFlush=true

# Set the threshold to debug mode
log4j.appender.FILE.Threshold=debug

# Set the append to false, should not overwrite
log4j.appender.FILE.Append=true

# Set the maximum file size before rollover
log4j.appender.FILE.MaxFileSize=5KB

# Set the the backup index
log4j.appender.FILE.MaxBackupIndex=2

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n

如果想有一个XML配置文件，可以生成中提到的初始段，并添加相关的 RollingFileAppender 进行唯一额外的参数。

此示例配置说明每个日志文件的最大允许大小为5MB。当超过最大尺寸，新的日志文件将被创建并因为maxBackupIndex被定义为2，当第二个日志文件达到最大值，第一个日志文件将被删除，之后所有的日志信息将被回滚到第一个日志文件。

可以尝试 log4j - 示例程序使用上面的配置。

每天生成日志文件：

当想生成每一天的日志文件，以保持日志记录信息的良好记录。

日志记录信息纳入日常的基础文件，就必须它扩展FileAppender类，并继承其所有属性useorg.apache.log4j.DailyRollingFileAppender类。

有除了已如上所述为 FileAppender 只有一个重要的下列配置参数：

DatePattern控制使用下列滚动的时间表方式之一：

下面是一个示例配置文件log4j.properties生成日志文件滚动的在每天午夜。

# Define the root logger with appender file
log4j.rootLogger = DEBUG, FILE

# Define the file appender
log4j.appender.FILE=org.apache.log4j.DailyRollingFileAppender
# Set the name of the file
log4j.appender.FILE.File=${log}/log.out

# Set the immediate flush to true (default)
log4j.appender.FILE.ImmediateFlush=true

# Set the threshold to debug mode
log4j.appender.FILE.Threshold=debug

# Set the append to false, should not overwrite
log4j.appender.FILE.Append=true

# Set the DatePattern
log4j.appender.FILE.DatePattern='.' yyyy-MM-dd-a

# Define the layout for file appender
log4j.appender.FILE.layout=org.apache.log4j.PatternLayout
log4j.appender.FILE.layout.conversionPattern=%m%n

如果想使用XML配置文件，可以生成中提到的初始段，并添加相关DailyRollingFileAppender 唯一的额外参数和数据。

可以尝试在 log4j - 示例程序使用上面的配置。

log4j日志记录到数据库 - Log4j教程

log4j API提供 org.apache.log4j.jdbc.JDBCAppender 对象，它能够将日志信息在指定的数据库。

JDBCAppender 配置:

日志表配置：

开始使用基于JDBC日志，要创建在哪里保存日志信息的表。下面是创建日志表的SQL语句：

CREATE TABLE LOGS
(USER_ID VARCHAR(20) NOT NULL,
DATED DATE NOT NULL,
LOGGER VARCHAR(50) NOT NULL,
LEVEL VARCHAR(10) NOT NULL,
MESSAGE VARCHAR(1000) NOT NULL
);

配置文件示例：

以下是将用于将消息记录到一个日志表中的示例配置文件 log4j.properties的JDBCAppender

# Define the root logger with appender file
log4j.rootLogger = DEBUG, DB

# Define the DB appender
log4j.appender.DB=org.apache.log4j.jdbc.JDBCAppender

# Set JDBC URL
log4j.appender.DB.URL=jdbc:mysql://localhost/DBNAME

# Set Database Driver
log4j.appender.DB.driver=com.mysql.jdbc.Driver

# Set database user name and password
log4j.appender.DB.user=user_name
log4j.appender.DB.password=password

# Set the SQL statement to be executed.
log4j.appender.DB.sql=INSERT INTO LOGS
VALUES('%x','%d','%C','%p','%m')

# Define the layout for file appender
log4j.appender.DB.layout=org.apache.log4j.PatternLayout

这里使用的是MySQL数据库，必须要使用实际DBNAME，用户ID和在其中创建的日志表的数据库密码。SQL语句是使用日志表名和输入值到表，需要执行INSERT语句。

JDBCAppender不需要明确定义的布局。相反，使用PatternLayout 传递给它 SQL语句

如果想拥有相当于上述log4j.properties文件的XML配置文件，可以参考在这里的内容：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
<log4j:configuration>

<appender name="DB" class="org.apache.log4j.jdbc.JDBCAppender">
<param name="url" value="jdbc:mysql://localhost/DBNAME"/>
<param name="driver" value="com.mysql.jdbc.Driver"/>
<param name="user" value="user_id"/>
<param name="password" value="password"/>
<param name="sql" value="INSERT INTO LOGS VALUES('%x',
'%d','%C','%p','%m')"/>
<layout class="org.apache.log4j.PatternLayout">
</layout>

</appender>

<logger name="log4j.rootLogger" additivity="false">
<level value="DEBUG"/>
<appender-ref ref="DB"/>
</logger>

</log4j:configuration>

示例程序：

下面的Java类是一个非常简单的Java应用程序使用Log4J日志库例子，初始化，然后使用。

import org.apache.log4j.Logger;
import java.sql.*;
import java.io.*;
import java.util.*;

public class log4jExample{
/* Get actual class name to be printed on */
static Logger log = Logger.getLogger(
log4jExample.class.getName());

public static void main(String[] args)
throws IOException,SQLException{

log.debug("Debug");
log.info("Info");
}
}

编译和运行：

下面是步骤编译并运行上述程序。确保进行编译和执行之前，适当地设置PATH和CLASSPATH。

所有的库应该在CLASSPATH以及log4j.properties文件应该在PATH可用。所以有以下几点：

• 创建log4j.properties如上图所示。
• 创建log4jExample.java如上图所示，并对其进行编译。
• 执行log4jExample二进制运行程序。

现在检查DBNAME数据库里面日志表，发现下面的条目（记录）：

mysql > select * from LOGS;
+---------+------------+--------------+-------+---------+
| USER_ID | DATED | LOGGER | LEVEL | MESSAGE |
+---------+------------+--------------+-------+---------+
| | 2010-05-13 | log4jExample | DEBUG | Debug |
| | 2010-05-13 | log4jExample | INFO | Info |
+---------+------------+--------------+-------+---------+
2 rows in set (0.00 sec)

注：此处X被用于产生该记录事件的线程相关联输出的NDC（嵌套诊断上下文）。使用NDC来区分客户的服务器端组件处理多个客户端。检查Log4J的手册以获取更多信息。