Loggers

QWen Max 中英对照 Loggers

Spring Boot Actuator 包含在运行时查看和配置应用程序日志级别的功能。你可以查看整个列表，也可以查看单个 logger 的配置，该配置由显式配置的日志级别以及日志框架赋予它的有效日志级别组成。这些级别可以是以下之一：

• TRACE

• DEBUG

• INFO

• WARN

• ERROR

• FATAL

• OFF

• null

null 表示没有显式配置。

配置 Logger

要配置指定的 logger，请向该资源的 URI POST 一个部分实体，如下例所示：

{
	"configuredLevel": "DEBUG"
}

提示

要“重置”记录器的特定级别（并改用默认配置），可以将 configuredLevel 的值设为 null。

OpenTelemetry

默认情况下，通过 OpenTelemetry 的日志记录未配置。你需要提供 OpenTelemetry 日志端点的位置来对其进行配置：

Properties

management.opentelemetry.logging.export.otlp.endpoint=https://otlp.example.com:4318/v1/logs

YAML

management:
  opentelemetry:
    logging:
      export:
        otlp:
          endpoint: "https://otlp.example.com:4318/v1/logs"

备注

OpenTelemetry Logback appender 和 Log4j appender 并不属于 Spring Boot。更多详情，请参见 OpenTelemetry Java instrumentation GitHub 仓库 中的 OpenTelemetry Logback appender 或 OpenTelemetry Log4j2 appender。

提示

你需要在 logback-spring.xml 或 log4j2-spring.xml 配置文件中配置 appender，才能使 OpenTelemetry 日志功能正常工作。

Logback 和 Log4j 的 OpenTelemetryAppender 都需要访问一个 OpenTelemetry 实例才能正常工作。该实例必须在应用程序启动期间以编程方式设置，可以按如下方式进行：

Java

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

}

Kotlin

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(
	private val openTelemetry: OpenTelemetry
) : InitializingBean {

	override fun afterPropertiesSet() = OpenTelemetryAppender.install(openTelemetry)

}