Logback MDC

Mapped Diagnostic Contexts (MDC)   （译：诊断上下文映射）

Logback的设计目标之一是审计和调试复杂的分布式应用程序。大多数实际的分布式系统需要同时处理来自多个客户端的请求。为了区分开每个客户端的日志，也为了能够快速定位某个请求日志来自哪个客户端，最简单地方式是，给每个客户端的每个日志请求一个唯一标记。

为了对每个请求进行惟一的标记，用户将上下文信息放入MDC中。

MDC类只包含静态方法。它允许开发人员将信息放在诊断上下文中，然后通过某些logback组件检索这些信息。MDC在每个线程的基础上管理上下文信息。通常，在开始服务新的客户端请求时，开发人员会将相关的上下文信息（如客户端id、客户端IP地址、请求参数等）插入到MDC中。如果配置得当，Logback组件将自动在每个日志条目中包含此信息。另外请注意，子线程不会自动继承其父线程的映射诊断上下文的副本。

下面是一个例子：

假设Logback配置文件是这样配置的：

运行这段程序，将会看到以下输出：

请注意，在PatternLayout转换模式中使用%X

补充一句，如果不知道这些格式字符串怎么写，可以参加 ch.qos.logback.classic.PatternLayout

通常，服务器用多个线程为多个客户端提供服务。尽管MDC类中的方法是静态的，但是诊断上下文是在每个线程的基础上进行管理的，允许每个服务器线程都带有不同的MDC戳记。诸如put()和get()之类的MDC操作只影响当前线程的MDC和当前线程的子线程。其他线程中的MDC不受影响。由于MDC信息是在每个线程的基础上管理的，所以每个线程都有自己的MDC副本。因此，开发人员在使用MDC编程时不需要担心线程安全或同步问题，因为它可以安全、透明地处理这些问题。

正如我们所看到的，MDC非常有用。我们可以在MDC中设置用户名，这样便可以从日志中追踪用户行为。但是，因为MDC是在每个线程的基础上管理数据的，而且项目中基本上都是用的线程池，所以回收线程的服务器可能会导致MDC中包含错误信息。为了使MDC中包含的信息在处理请求时始终正确，一种可能的方法是在线程开始时存储用户名，并在线程结束时删除它。在这种情况下，servlet过滤器就派上用场了。

MDC与线程管理

worker线程不总是可以从启动线程那里继承诊断上下文副本，例如当使用 java.util.concurrent.Executors来管理线程时就不能。在这种情况下，推荐在提交任务到executor之前在原始线程上先调用MDC.getCopyOfContextMap()。当任务启动后，第一个动作应该先调用MDC.setContextMapValues()来关联这个原始MDC的副本。

MDCInsertingServletFilter

在Web应用程序中，知道给定的HTTP请求的主机名、请求URL以及user-agent等信息通常是非常有用的。MDCInsertingServletFilter插入这些数据到MDC中。

为了引入MDCInsertingServletFilter过滤器，添加以下到web.xml中

如果有多个过滤器，请务必确保MDCInsertingServletFilter在所有其他过滤器的前面。

示例：追踪用户行为（举个栗子）

使用过滤器或者拦截器都行

pom.xml

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
 4     <modelVersion>4.0.0</modelVersion>
 5     <parent>
 6         <groupId>org.springframework.boot</groupId>
 7         <artifactId>spring-boot-starter-parent</artifactId>
 8         <version>2.2.1.RELEASE</version>
 9         <relativePath/> <!-- lookup parent from repository -->
10     </parent>
11     <groupId>com.cjs.example</groupId>
12     <artifactId>demo123</artifactId>
13     <version>0.0.1-SNAPSHOT</version>
14     <name>demo123</name>
15 
16     <properties>
17         <java.version>1.8</java.version>
18     </properties>
19 
20     <dependencies>
21         <dependency>
22             <groupId>org.springframework.boot</groupId>
23             <artifactId>spring-boot-starter-web</artifactId>
24         </dependency>
25 
26         <dependency>
27             <groupId>ch.qos.logback</groupId>
28             <artifactId>logback-classic</artifactId>
29             <version>1.2.3</version>
30         </dependency>
31 
32         <dependency>
33             <groupId>org.projectlombok</groupId>
34             <artifactId>lombok</artifactId>
35             <optional>true</optional>
36         </dependency>
37     </dependencies>
38 
39     <build>
40         <plugins>
41             <plugin>
42                 <groupId>org.springframework.boot</groupId>
43                 <artifactId>spring-boot-maven-plugin</artifactId>
44             </plugin>
45         </plugins>
46     </build>
47 
48 </project>

过滤器配置

 1 package com.cjs.