此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.4.0spring-doc.cn

Logging

Spring Boot Actuator 包括在运行时查看和配置应用程序的日志级别的能力。 您可以查看整个列表或单个 Logger 的配置,该配置由显式配置的日志记录级别以及日志记录框架为其提供的有效日志记录级别组成。 这些级别可以是以下级别之一:spring-doc.cn

null表示没有显式配置。spring-doc.cn

配置 Logger

要配置给定的 Logger,需要资源URI的部分实体,如下例所示:POSTspring-doc.cn

{
	"configuredLevel": "DEBUG"
}
要 “重置” 记录器的特定级别(并改用默认配置),可以将值 作为 .nullconfiguredLevel

开放遥测

默认情况下,未配置通过 OpenTelemetry 进行日志记录。 您必须提供 OpenTelemetry logs 终端节点的位置才能对其进行配置:spring-doc.cn

management.otlp.logging.endpoint=https://otlp.example.com:4318/v1/logs
management:
  otlp:
    logging:
      endpoint: "https://otlp.example.com:4318/v1/logs"
OpenTelemetry Logback appender 和 Log4j appender 不是 Spring Boot 的一部分。 有关更多详细信息,请参阅 OpenTelemetry Java 检测 GitHub 存储库中的 OpenTelemetry Logback appenderOpenTelemetry Log4j2 appender
您必须在 or 配置中配置 appender 才能使 OpenTelemetry 日志记录正常工作。logback-spring.xmllog4j2-spring.xml

对于 Logback 和 Log4j,都需要访问 OpenTelemetry 实例才能正常运行。 在应用程序启动期间,必须以编程方式设置此实例,可以像这样完成:OpenTelemetryAppenderspring-doc.cn

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);
	}

}