1.11. 使用其他日志记录 API

PDF

Quarkus 依赖于 JBoss Logging 库来满足所有日志记录要求。假设您使用依赖于其他日志记录库的库，如 Apache Commons Logging、Log4j 或 SLF4J。在这种情况下，从依赖项中排除它们，并使用其中一个 JBoss Logging 适配器。这在构建原生可执行文件时尤为重要，因为在编译原生可执行文件时可能会遇到类似如下的问题：

Caused by java.lang.ClassNotFoundException: org.apache.commons.logging.impl.LogFactoryImpl

日志记录实施不包括在原生可执行文件中，但您可以使用 JBoss Logging 适配器解决这个问题。这些适配器可用于流行的开源日志记录组件，如下一章节中所述。

1.11.1. 在应用程序中添加日志适配器

对于不是 jboss-logging 的每个日志记录 API：添加日志记录适配器库，以确保通过这些 API 记录的消息被路由到 JBoss Log Manager 后端。对于作为 Quarkus 扩展依赖项的库，这个步骤不需要扩展自动处理它。 Apache Commons Logging: 使用 Maven：

<dependency>
    <groupId>org.jboss.logging</groupId>
    <artifactId>commons-logging-jboss-logging</artifactId>
</dependency>

使用 Gradle ：

implementation("org.jboss.logging:commons-logging-jboss-logging")

Log4j: 使用 Maven：

<dependency>
    <groupId>org.jboss.logmanager</groupId>
    <artifactId>log4j-jboss-logmanager</artifactId>
</dependency>

使用 Gradle ：

implementation("org.jboss.logmanager:log4j-jboss-logmanager")

Log4j 2: 使用 Maven：

<dependency>
    <groupId>org.jboss.logmanager</groupId>
    <artifactId>log4j2-jboss-logmanager</artifactId>
</dependency>

使用 Gradle ：

implementation("org.jboss.logmanager:log4j2-jboss-logmanager")

注意

不要包含任何 Log4j 依赖项，因为 log4j2-jboss-logmanager 库包含使用 Log4j 作为日志实施所需的所有操作。 SLF4J: 使用 Maven：

<dependency>
    <groupId>org.jboss.slf4j</groupId>
    <artifactId>slf4j-jboss-logmanager</artifactId>
</dependency>

使用 Gradle ：

implementation("org.jboss.slf4j:slf4j-jboss-logmanager")

package me.sample; import io.quarkus.logging.Log; import jakarta.ws.rs.GET; import jakarta.ws.rs.Path; import org.jboss.logmanager.MDC; import java.util.UUID; @Path("/hello/jboss") public class GreetingResourceJbossLogging { @Path("/test") public String greeting() { MDC.put("request.id", UUID.randomUUID().toString()); MDC.put("request.path", "/hello/test"); Log.info("request received"); return "hello world!"; 如果您使用以下行配置日志格式：

quarkus.log.console.format=%d{HH:mm:ss} %-5p request.id=%X{request.id} request.path=%X{request.path} [%c{2.}] (%t) %s%n

您会收到包含 MDC 数据的消息：

08:48:13 INFO request.id=c37a3a36-b7f6-4492-83a1-de41dbc26fe2 request.path=/hello/test [me.sa.GreetingResourceJbossLogging] (executor-thread-1) request received

1.11. 使用其他日志记录 API

1.11.1. 在应用程序中添加日志适配器

1.11.2. 使用 MDC 添加上下文日志信息

1.11.2.1. 添加和读取 MDC 数据

1.11.2.2. MDC 和支持的日志记录 API

1.11.2.3. MDC propagation