应用中日志的优雅使用(整合log4j2与SLF4J)

一些基础原则(来自阿里java开发手册)

应用中不可直接使用日志系统（ Log4j、 Logback） 中的 API，而应依赖使用日志框架（ SLF4J、 JCL–Jakarta Commons Logging） 中的 API，使用门面模式的日志框架，有利于维护和各个类的日志处理方式统一。 日志框架（ SLF4J、 JCL–Jakarta Commons Logging）的使用方式（推荐使用 SLF4J） import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

private static final Logger logger = LoggerFactory.getLogger(Test.class);

所有日志文件至少保存 15 天，因为有些异常具备以“周” 为频次发生的特点。 对于当天日志，以“应用名.log” 来保存，保存在/home/用户名/software/应用名/logs/目录下，过往日志格式为: {logname}.log.{保存日期}.gz，日期格式： yyyy-MM-dd 。 在日志输出时，字符串变量之间的拼接使用占位符的方式 。 LOGGER.info("SparkApp state: {}.", handle.getState().toString());

对于trace/debug级别的日志输出，必须进行日志级别的开关判断。 if (LOGGER.isDebugEnabled()) {

LOGGER.debug("hadoopConfDir=[{}].", hadoopConfDir);

LOGGER.debug("yarnConfDir=[{}].", hadoopConfDir);

LOGGER.debug("javaHome=[{}].", javaHome);

LOGGER.debug("sparkHome=[{}].", sparkHome);

LOGGER.debug("appReSourcePath=[{}].", appReSourcePath);

LOGGER.debug("appMainClass=[{}].", appMainClass);

LOGGER.debug("hadoopUserName=[{}].", hadoopUserName);

LOGGER.debug("retryMaxCount[{}].", retryMaxCount);

}

禁止直接使用System.out或System.err输出日志或使用e.printStackTrace()打印异常堆栈。 标准日志输出与标准错误输出文件每次 Jboss 重启时才滚动，如果大量输出送往这两个文件，容易造成文件大小超过操作系统大小限制。 异常信息应该包括两类信息：案发现场信息和异常堆栈信息。如果不处理，那么通过关键字 throws 往上抛出。 logger.error("inputParams:{} and errorMessage:{}", 各类参数或者对象 toString(), e.getMessage(), e);

除非是海外项目或者国外服务器，需要全部英文。国内使用中文进行输出和注释，避免词不达意或解释歧义的情况。

使用实例 整合log4j2与SLF4J

结合使用的原理：通过SLF4J的api调用log4j2的api，再由log4j2的api调用log4j2的core。

gradle引入依赖

// >>>>>>日志依赖>>>>>>

// log4j2的日志实现核心包，其依赖了log4j-api（log4j2的日志门面）

implementation group: 'org.apache.logging.log4j', name: 'log4j-core', version: '2.20.0'

// log4j2和slf4j的连接包，版本与log4j2核心包一致

implementation group: 'org.apache.logging.log4j', name: 'log4j-slf4j-impl', version: '2.20.0'

// slf4j的日志门面

implementation group: 'org.slf4j', name: 'slf4j-api', version: '1.7.25'

创建log4j2.xml配置文件。

log4j2加载配置文件机制：

Log4j将检查"log4j2.configurationFile"系统属性，如果设置了，将尝试使用与文件扩展名匹配的ConfigurationFactory来加载配置。请注意，这并不局限于本地文件系统中的某个位置，可能包含一个URL。如果没有设置系统属性，属性ConfigurationFactory将在classpath中寻找log4j2-test.properties。如果没有找到这样的文件，YAML ConfigurationFactory将在classpath中寻找log4j2-test.yaml或log4j2-test.yml。如果没有找到这样的文件，JSON ConfigurationFactory将在classpath中寻找log4j2-test.json或log4j2-test.jsn。如果没有找到这样的文件，XML ConfigurationFactory将在classpath中寻找log4j2-test.xml。如果不能找到测试文件，属性ConfigurationFactory将在classpath中寻找log4j2.properties。如果不能找到属性文件，YAML ConfigurationFactory将在classpath上寻找log4j2.yaml或log4j2.yml。如果YAML文件无法定位，JSON ConfigurationFactory将在classpath上寻找log4j2.json或log4j2.jsn。如果不能找到JSON文件，XML ConfigurationFactory将尝试在classpath上找到log4j2.xml。如果不能找到配置文件，将使用DefaultConfiguration。这将导致日志输出到控制台。

示例：

/home/china-unicorn/logs/monitor

china-unicorn

[%d][%p][%t][%c:%L] %m%n

${log_path}/${logfile}.log-%d{yyyy-MM-dd}-%i.gz

filePattern="${file_pattern}">

创建TestLog.java

package com.donny.bigdata.test;

import org.apache.logging.log4j.LogManager;

import org.apache.logging.log4j.core.LoggerContext;

import org.slf4j.Logger;

import org.slf4j.LoggerFactory;

import java.io.File;

/**

* @author 1792998761@qq.com

* @date 2023/4/3 19:47

*/

public class TestLog {

private static final Logger LOGGER = LoggerFactory.getLogger(TestLog.class);

static {

// 初始化log4j2日志-- 采用将自定义配置文件路径的方式

LoggerContext context = (org.apache.logging.log4j.core.LoggerContext) LogManager.getContext(false);

File file = new File("conf/log4j2.xml");

context.setConfigLocation(file.toURI());

if (LOGGER.isDebugEnabled()) {

LOGGER.debug("log4j2初始化完毕");

}

}

public static void main(String[] args) {

LOGGER.info("中文");

}

}

结果

[2023-04-04 14:58:06,719][DEBUG][main][com.donny.bigdata.test.TestLog:23] log4j2初始化完毕

[2023-04-04 14:58:06,719][INFO][main][com.donny.bigdata.test.TestLog:28] 中文

Gradle下日志包的冲突

利用dependencies，打印出依赖树。

命令式gradle :${modulename}:dependencies,${modulename}是个占位符，里面用模块名（project）替换。或者使用IDEA开发也可以通过执行项目Gradle面板中Tasks->help->dependencies任务，也打印出该模块对应的依赖树。

依赖树中包含以下部分

annotationProcessorcompileClasspathcompileOnlydefaultimplementationmainSourceElementsruntimeClasspathruntimeElementsruntimeOnlytestAnnotationProcessortestCompileClasspathtestCompileOnlytestImplementationtestResultsElementsForTesttestRuntimeClasspathtestRuntimeOnly

部分举例展示：

compileClasspath - Compile classpath for source set 'main'.

+--- org.apache.logging.log4j:log4j-core:2.20.0

| \--- org.apache.logging.log4j:log4j-api:2.20.0

+--- org.slf4j:slf4j-api:1.7.25

+--- org.apache.logging.log4j:log4j-slf4j-impl:2.20.0

| +--- org.apache.logging.log4j:log4j-api:2.20.0

| \--- org.slf4j:slf4j-api:1.7.25

+--- com.sun.mail:jakarta.mail:2.0.1

| \--- com.sun.activation:jakarta.activation:2.0.1

...

...

...

implementation - Implementation only dependencies for source set 'main'. (n)

+--- org.apache.logging.log4j:log4j-core:2.20.0 (n)

+--- org.slf4j:slf4j-api:1.7.25 (n)

+--- org.apache.logging.log4j:log4j-slf4j-impl:2.20.0 (n)

+--- com.sun.mail:jakarta.mail:2.0.1 (n)

+--- jakarta.mail:jakarta.mail-api:2.0.1 (n)

+--- io.netty:netty-all:4.1.90.Final (n)

+--- org.elasticsearch.client:elasticsearch-rest-high-level-client:6.7.2 (n)

+--- org.elasticsearch.client:transport:6.7.2 (n)

+--- org.elasticsearch.client:elasticsearch-rest-client:6.7.2 (n)

+--- org.elasticsearch.client:elasticsearch-rest-client-sniffer:6.7.2 (n)

+--- org.apache.hadoop:hadoop-client:2.7.3 (n)

+--- org.apache.spark:spark-core_2.11:2.3.3 (n)

+--- org.apache.kafka:kafka-clients:1.0.0 (n)

+--- org.apache.hbase:hbase-client:1.1.2 (n)

+--- org.apache.hive:hive-jdbc:1.2.1 (n)

+--- com.clickhouse:clickhouse-jdbc:0.4.0 (n)

\--- org.apache.zookeeper:zookeeper:3.4.6 (n)

...

...

...

runtimeClasspath - Runtime classpath of source set 'main'.

+--- org.apache.logging.log4j:log4j-core:2.20.0

| \--- org.apache.logging.log4j:log4j-api:2.20.0

+--- org.slf4j:slf4j-api:1.7.25

+--- org.apache.logging.log4j:log4j-slf4j-impl:2.20.0

| +--- org.apache.logging.log4j:log4j-api:2.20.0

| +--- org.slf4j:slf4j-api:1.7.25

| \--- org.apache.logging.log4j:log4j-core:2.20.0 (*)

+--- com.sun.mail:jakarta.mail:2.0.1

| \--- com.sun.activation:jakarta.activation:2.0.1

+--- jakarta.mail:jakarta.mail-api:2.0.1

...

...

...

在其中寻找冲突的包。

处理方式

优先排除冲突依赖 implementation("org.apache.hadoop:hadoop-client:2.9.1") {

exclude group: 'org.slf4j', module: 'slf4j-log4j12'

}

强制使用某个依赖 configurations.all {

resolutionStrategy {

force 'org.slf4j:slf4j-api:1.7.25'

}

}

推荐阅读

评论可见，请评论后查看内容，谢谢！！！
 您阅读本篇文章共花了： 


大家都在找：

log4j：log4j2漏洞

Java：java下载

大家都在看：

java log4j apache 使用 SLF4J 进行高效的日志记录（@slf4j 注解）

简介: SLF4J（Simple Logging Facade for Java）是一个为 Java 应用程序提供日志记录的简单日志门面，它的设计目标是在不同的日志实现之间提供统一的接口，让开发人员能...

单元测试 JAVA中使用log4j及slf4j进行日志输出的方法

JAVA中输出日志比较常用的是log4j，这里讲下log4j的配置和使用方法，以及slf4j的使用方法。 一、下载log4j的架包，并导入项目中，如下： 二、创建log4j.properties配置文...

java log日志使用教程(slf4j log4j logback)

目录一，前言二，常用日志框架框架对比2.1 slf4j 框架2.2 logback 框架 配置日志级别过滤filter2.3 log4j2框架三，log4j vs logback    推荐logba...

apache Java框架——日志整合slf4j+log4j2

简介文档地址官网地址：https://logging.apache.org/log4j/2.x/manual/usage.html文档地址：PDFLog4j 2 用户指南可在此站点上获得，也可作为可下...

Java中常见的日志包分析（Log4j、Logback、SLF4J等）

Java中常见的日志jar包包括Log4j、Logback、SLF4J、java.util.logging等。它们各自的作用和应用场景如下：作用：Log4j是Apache的一个开源项目，提供日志记录的...

log4j 学习Java日志框架之——搞懂日志门面（JCL+SLF4J）

文章目录系列文章目录一、什么是日志门面1、门面模式（外观模式）2、日志门面二、了解JCL1、JCL组件结构2、JCL案例（1）JCL默认实现（2）导入log4j测试原有程序三、SLF4J简介四、SLF...

slf4j 日志 Log4j2 -- 使用

目录简介特性使用基本配置文件日志拆分简介Apache Log4j 2是对Log4j的升级，它比其前身Log4j 1.x提供了重大改进，并提供了Logback中可用的许多改进，同时修复了Logback架...

java 日志框架Log4j、JUL、JCL、Slf4j、Logback、Log4j2

1. JAVA日志框架 1.1 为什么程序需要记录日志 我们不可能实时的24小时对系统进行人工监控，那么如果程序出现异常错误时要如何排查呢？并且系统在运行时做了哪些事情我们又从何得知呢？这个时候日志这...

Java日志系统log4j2的使用配置和异步日志使用

目录 1. log4j21.1 log4j2介绍1.2 Log4j2入门1.2.1 log4j2(日志门面 + 日志框架)使用1.2.2 slf4j + log4j2使用 1.3 Log4j2...

log4j java apache 解决Slf4j日志不打印问题

日志不打印的问题，很让人头疼，也是我们经常遇到的问题。 日常站点状态巡检时发现有异常日志，定位到日志位置，看其上线文自定义输出的日志时却发现，自己加的日志都没输出。排查了一下初步定位到，这个类中日志输...