Java中log4j日志级别配置详解

前言

在Java应用程序中，日志是非常重要的组成部分。它可以帮助我们快速定位问题，进行故障排除。log4j是Java程序中常用的日志框架，本文主要讲解log4j中日志级别的配置。

什么是日志级别？

简单来说，日志级别就是指日志的重要程度。比如，我们可以规定一个日志级别为INFO，只输出高于INFO级别的日志。Java中log4j日志级别共分以下几个级别（按重要程度递增排序）：

• ALL: 最低级别，打印所有日志；
• TRACE: 追踪级别，用于追踪代码运行细节；
• DEBUG: 调试级别，用于调试代码、寻找问题；
• INFO: 信息级别，用于打印一些重要信息；
• WARN: 警告级别，用于打印一些潜在问题或可能引发错误的操作；
• ERROR: 错误级别，用于打印一些异常信息、错误信息，会影响系统正常运行；
• FATAL: 致命级别，用于打印一些致命性的错误，可能导致系统崩溃。

默认情况下，log4j的日志输出级别为DEBUG。

如何设置日志级别？

使用log4j进行日志输出时，可以通过以下方法设置日志级别：

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="consoleAppender" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" />
        </layout>
    </appender>

    <!-- 设置日志级别为info -->
    <root>
        <priority value="info" />
        <appender-ref ref="consoleAppender" />
    </root>
</log4j:configuration>

上面的代码是一个log4j配置文件的示例，在root标签下的<priority>标签就可以设置输出日志的级别。如果想要输出DEBUG级别及以上的日志，可以将value属性修改为DEBUG即可。同理，如果想要输出INFO及以上级别的日志，可以将value属性修改为INFO。

实例说明

下面是两个在Java应用程序中采用log4j日志级别的示例说明：

示例1：输出INFO级别及以上的日志

修改log4j配置文件，设置输出日志级别为INFO：

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="consoleAppender" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" />
        </layout>
    </appender>

    <!-- 设置日志级别为info -->
    <root>
        <priority value="info" />
        <appender-ref ref="consoleAppender" />
    </root>
</log4j:configuration>

在Java程序中输出日志：

import org.apache.log4j.Logger;

public class Log4jDemo {
    private static final Logger LOGGER = Logger.getLogger(Log4jDemo.class);

    public static void main(String[] args) {
        LOGGER.debug("这是debug级别的日志信息");
        LOGGER.info("这是info级别的日志信息");
        LOGGER.warn("这是warn级别的日志信息");
        LOGGER.error("这是error级别的日志信息");
        LOGGER.fatal("这是fatal级别的日志信息");
    }
}

结果：

2022-06-01 14:20:45,014 [main] INFO  Log4jDemo - 这是info级别的日志信息
2022-06-01 14:20:45,014 [main] WARN  Log4jDemo - 这是warn级别的日志信息
2022-06-01 14:20:45,014 [main] ERROR Log4jDemo - 这是error级别的日志信息
2022-06-01 14:20:45,014 [main] FATAL Log4jDemo - 这是fatal级别的日志信息

从上面的输出结果可以看出，仅输出了INFO及以上级别的日志信息。

示例2：输出DEBUG级别及以上的日志

修改log4j配置文件，设置输出日志级别为DEBUG：

<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
    <appender name="consoleAppender" class="org.apache.log4j.ConsoleAppender">
        <layout class="org.apache.log4j.PatternLayout">
            <param name="ConversionPattern" value="%d [%t] %-5p %c - %m%n" />
        </layout>
    </appender>

    <!-- 设置日志级别为debug -->
    <root>
        <priority value="debug" />
        <appender-ref ref="consoleAppender" />
    </root>
</log4j:configuration>

在Java程序中输出日志：

import org.apache.log4j.Logger;

public class Log4jDemo {
    private static final Logger LOGGER = Logger.getLogger(Log4jDemo.class);

    public static void main(String[] args) {
        LOGGER.debug("这是debug级别的日志信息");
        LOGGER.info("这是info级别的日志信息");
        LOGGER.warn("这是warn级别的日志信息");
        LOGGER.error("这是error级别的日志信息");
        LOGGER.fatal("这是fatal级别的日志信息");
    }
}

结果：

2022-06-01 14:24:07,742 [main] DEBUG Log4jDemo - 这是debug级别的日志信息
2022-06-01 14:24:07,742 [main] INFO  Log4jDemo - 这是info级别的日志信息
2022-06-01 14:24:07,742 [main] WARN  Log4jDemo - 这是warn级别的日志信息
2022-06-01 14:24:07,742 [main] ERROR Log4jDemo - 这是error级别的日志信息
2022-06-01 14:24:07,742 [main] FATAL Log4jDemo - 这是fatal级别的日志信息

从上面的输出结果可以看出，输出了DEBUG及以上级别的日志信息。

总结

设置日志级别可以让我们更加灵活地控制日志输出的信息量，以便于更好地定位问题。log4j以及其他日志框架都有类似的设置方法，学习了log4j的日志级别配置，其他框架的使用也会得心应手了。