此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Boot 3.4.0! |
Logging
Spring Boot Actuator 包括在运行时查看和配置应用程序的日志级别的能力。 您可以查看整个列表或单个 Logger 的配置,该配置由显式配置的日志记录级别以及日志记录框架为其提供的有效日志记录级别组成。 这些级别可以是以下级别之一:
-
TRACE
-
DEBUG
-
INFO
-
WARN
-
ERROR
-
FATAL
-
OFF
-
null
null
表示没有显式配置。
配置 Logger
要配置给定的 Logger,需要资源URI的部分实体,如下例所示:POST
{
"configuredLevel": "DEBUG"
}
要 “重置” 记录器的特定级别(并改用默认配置),可以将值 作为 .null configuredLevel |
开放遥测
默认情况下,未配置通过 OpenTelemetry 进行日志记录。 您必须提供 OpenTelemetry logs 终端节点的位置才能对其进行配置:
-
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 Java 检测 GitHub 存储库中的 OpenTelemetry Logback appender 或 OpenTelemetry Log4j2 appender。 |
您必须在 or 配置中配置 appender 才能使 OpenTelemetry 日志记录正常工作。logback-spring.xml log4j2-spring.xml |
对于 Logback 和 Log4j,都需要访问 OpenTelemetry
实例才能正常运行。
在应用程序启动期间,必须以编程方式设置此实例,可以像这样完成:OpenTelemetryAppender
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);
}
}