Logback日志上下文

Logback 日志上下文详解

在现代应用程序中，日志是用于调试、监控和诊断系统行为的关键工具。Logback 是 Java 世界中最常用的日志框架之一，它不仅提供了灵活的日志输出和格式化功能，还支持日志上下文（Logging Context），帮助开发者管理和定制日志信息。

1. 什么是 Logback 日志上下文（Logging Context）？

日志上下文（Logging Context）是 Logback 体系中的一个核心概念，负责管理日志的全局状态。每个应用程序中 Logback 都有一个默认的日志上下文，它是日志配置的顶层容器，控制所有日志记录器（Logger）和附加器（Appender）的行为。日志上下文主要包含：

配置项：如 Appender、Logger 和 Layout 等日志配置。
全局属性：一些公共的上下文信息，可以在日志中动态使用。
MDC（Mapped Diagnostic Context）：提供线程范围内的上下文信息。
NDC（Nested Diagnostic Context）：提供嵌套的上下文信息。

通过日志上下文，开发者可以为应用中的日志配置公共的上下文信息，并根据需要动态调整日志输出行为。

2. 日志上下文的基本使用

2.1 设置日志上下文属性

Logback 日志上下文允许开发者定义全局属性，可以在日志中动态使用这些属性。可以通过 logback.xml 配置文件中的 <property> 标签定义全局属性。

<configuration><!-- 设置全局属性 --><property name="applicationName" value="MyApp"/><property name="logDir" value="/var/logs/myapp"/><appender name="FILE" class="ch.qos.logback.core.FileAppender"><file>${logDir}/app.log</file><encoder><pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg [%X{traceId}]%n</pattern></encoder></appender><root level="INFO"><appender-ref ref="FILE"/></root>
</configuration>

通过 <property> 标签定义的 applicationName 和 logDir 属性，可以在配置文件的其他地方通过 ${propertyName} 引用。
%X{traceId} 是对 MDC 中 traceId 属性的引用，表示每一条日志都会输出与当前线程关联的 traceId（见下文）。

2.2 动态设置属性

有时在程序运行时动态设置日志上下文中的属性也是必要的。可以通过 LoggerContext 类进行动态操作。

import ch.qos.logback.classic.LoggerContext;
import org.slf4j.LoggerFactory;LoggerContext context = (LoggerContext) LoggerFactory.getILoggerFactory();
context.putProperty("serverId", "server-123");

通过 LoggerContext 的 putProperty 方法，可以在程序运行时动态设置全局属性。配置文件中可以使用 ${serverId} 来引用这个属性。

3. MDC（Mapped Diagnostic Context）

MDC 是 Logback 提供的一种机制，允许为每个线程存储一些上下文信息，并将这些信息附加到每条日志中。MDC 的典型用途是在多线程环境下，通过在每个线程中设置唯一的标识（如 traceId 或 userId），帮助开发者追踪同一业务请求相关的日志。

3.1 设置和获取 MDC 信息

在日志输出中，可以通过 SLF4J 提供的 MDC 类进行上下文数据的设置和获取。

import org.slf4j.MDC;public class MyService {public void processRequest() {// 设置 MDC 信息MDC.put("traceId", "12345-ABCDE");// 业务逻辑logger.info("Processing request");// 清除 MDC 信息MDC.clear();}
}

在 logback.xml 中配置日志格式时，可以通过 %X{key} 来引用 MDC 中的属性。例如：

<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg [%X{traceId}]%n</pattern>

输出的日志可能如下所示：

2024-09-08 10:15:30 [main] INFO  MyService - Processing request [12345-ABCDE]

3.2 MDC 的典型应用场景

分布式系统中的追踪：在分布式系统中，每个请求通常会通过多个微服务。在请求开始时生成唯一的 traceId，并将其通过 MDC 传递给各个服务，日志中打印该 traceId，以便在系统中追踪一个请求的整个生命周期。
用户会话日志：在处理与用户相关的请求时，可以将 userId 放入 MDC 中，日志会自动输出相关的用户信息。

3.3 MDC 清理

使用 MDC 时，需要注意在每个线程结束时清理 MDC 数据，防止线程复用时残留数据。可以通过 MDC.clear() 方法手动清理。

try {MDC.put("traceId", "12345");// 执行任务
} finally {MDC.clear();
}

4. NDC（Nested Diagnostic Context）

NDC 是 MDC 的嵌套版本，它用于提供嵌套的上下文信息。NDC 中的信息类似于堆栈，允许开发者在进入或退出某个方法时动态推入或弹出上下文信息。

4.1 NDC 使用示例

SLF4J 不再直接支持 NDC，但 Logback 仍然保留了该机制。开发者可以使用 NDC.push() 和 NDC.pop() 来维护嵌套上下文信息。

import org.slf4j.NDC;public class MyService {public void methodA() {NDC.push("methodA-context");logger.info("Inside methodA");methodB();NDC.pop();}public void methodB() {NDC.push("methodB-context");logger.info("Inside methodB");NDC.pop();}
}

在 logback.xml 中，可以通过 %x 占位符引用 NDC 的信息：

<pattern>%d{yyyy-MM-dd HH:mm:ss} [%thread] %-5level %logger{36} - %msg %x%n</pattern>

日志输出可能如下所示：

2024-09-08 10:15:30 [main] INFO  MyService - Inside methodA methodA-context
2024-09-08 10:15:31 [main] INFO  MyService - Inside methodB methodA-context methodB-context

NDC 允许你在多层次的方法调用中提供详细的上下文信息，有助于理解复杂的嵌套调用。

5. 扩展 Logback 日志上下文

除了使用 MDC 和 NDC，Logback 还支持自定义扩展日志上下文。可以通过继承 ContextAwareBase 类来创建自定义的日志上下文信息。

5.1 自定义扩展示例

import ch.qos.logback.core.spi.ContextAwareBase;public class CustomContext extends ContextAwareBase {public void logWithCustomContext() {logger.info("This is a custom log context message");}
}