在 spring boot actuator 中,日志端点通过 /actuator/loggers 路径暴露,允许开发者在不重启应用的情况下动态查询和修改特定包或类的日志级别。要使用它,需确保引入了 spring-boot-starter-actuator 依赖并配置了相应的权限,随后可以通过 http get 请求获取所有日志配置,或通过 put 请求将某个包的日志级别调整为 debug、info 等状态。

如何查询当前所有日志配置
查询当前所有日志配置需要向 /actuator/loggers 发送 GET 请求,返回的 JSON 结构包含 levels 数组和 loggers 对象。默认情况下,Actuator 会返回根日志器(root)以及所有已配置的包层级信息,开发者可以据此判断当前的全局日志级别和特定组件的详细设置。

{
"levels": [
"OFF",
"FATAL",
"ERROR",
"WARN",
"INFO",
"DEBUG",
"TRACE"
],
"loggers": {
"root": {
"configuredLevel": "INFO",
"effectiveLevel": "INFO"
},
"com.example.demo": {
"configuredLevel": null,
"effectiveLevel": "INFO"
}
}
}
如何动态修改指定包的日志级别
动态修改指定包的日志级别需要向 /actuator/loggers/{name} 发送 PUT 请求,并在请求体中指定 configuredLevel 字段。例如,将 com.example.demo 的日志级别设置为 DEBUG,只需提交包含该级别值的 JSON 对象,Actuator 会立即更新底层日志框架的配置,无需重启服务。
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

{
"configuredLevel": "DEBUG"
}
当日志级别未显式配置时 effectiveLevel 如何确定
当日志级别未显式配置时,effectiveLevel 会根据日志框架的继承规则从父级或根日志器继承。如果子包没有设置 configuredLevel,其 effectiveLevel 将与根日志器的级别保持一致,这确保了即使未单独配置,日志系统仍能按照全局策略输出信息。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










