跳到主要内容

日志记录器

DeepSeek V3 中英对照 Loggers

Spring Boot Actuator 包含了在运行时查看和配置应用程序日志级别的功能。你可以查看整个日志配置列表,或者查看单个日志记录器的配置,该配置由显式配置的日志级别以及日志框架赋予它的有效日志级别组成。这些级别可以是以下几种之一:

  • TRACE - 追踪

  • DEBUG - 调试

  • INFO - 信息

  • WARN - 警告

  • ERROR - 错误

  • FATAL - 致命

  • OFF - 关闭

  • null - 空

null 表示没有显式配置。

配置日志记录器

要配置给定的日志记录器,请将部分实体 POST 到资源的 URI,如下例所示:

{
"configuredLevel": "DEBUG"
}
json
提示

要“重置”日志记录器的特定级别(并使用默认配置),可以将 null 作为 configuredLevel 的值传递。

OpenTelemetry

默认情况下,未配置通过 OpenTelemetry 进行日志记录。您需要提供 OpenTelemetry 日志端点的位置来配置它:

management.otlp.logging.endpoint=https://otlp.example.com:4318/v1/logs
properties
备注

OpenTelemetry Logback appender 和 Log4j appender 并不属于 Spring Boot 的一部分。更多详细信息,请参阅 OpenTelemetry Java instrumentation GitHub 仓库 中的 OpenTelemetry Logback appenderOpenTelemetry Log4j2 appender

提示

你需要在 logback-spring.xmllog4j2-spring.xml 配置文件中配置 appender,以使 OpenTelemetry 日志记录正常工作。

OpenTelemetryAppender 对于 Logback 和 Log4j 都需要访问一个 OpenTelemetry 实例才能正常运行。这个实例必须在应用程序启动时通过编程方式设置,可以像这样进行:

import io.opentelemetry.api.OpenTelemetry;
import io.opentelemetry.instrumentation.logback.appender.v1_0.OpenTelemetryAppender;

import org.springframework.beans.factory.InitializingBean;
import org.springframework.stereotype.Component;

@Component
class OpenTelemetryAppenderInitializer implements InitializingBean {

private final OpenTelemetry openTelemetry;

OpenTelemetryAppenderInitializer(OpenTelemetry openTelemetry) {
this.openTelemetry = openTelemetry;
}

@Override
public void afterPropertiesSet() {
OpenTelemetryAppender.install(this.openTelemetry);
}

}
java