日志器

Spring Boot Actuator 包含了在运行时查看和配置应用日志级别的能力。你可以查看整个列表或单个日志器的配置,其配置由显式配置的日志级别和日志框架赋予的有效日志级别共同组成。这些级别可以是以下之一:

  • TRACE

  • DEBUG

  • INFO

  • WARN

  • ERROR

  • FATAL

  • OFF

  • null

null 表示没有显式配置。

配置日志器

要配置给定的日志器,请向资源的 URI 发送 POST 请求,并携带部分实体,如下例所示:

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

OpenTelemetry

默认情况下,通过 OpenTelemetry 进行日志记录未配置。你必须提供 OpenTelemetry 日志端点的位置来配置它

  • Properties

  • YAML

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 Logback appenderOpenTelemetry Log4j2 appender(位于 OpenTelemetry Java instrumentation GitHub 仓库中)。
你必须在你的 logback-spring.xmllog4j2-spring.xml 配置中配置 appender,才能使 OpenTelemetry 日志记录工作。

Logback 和 Log4j 的 OpenTelemetryAppender 都需要访问 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);
	}

}